如何在GA4的batchRunReports中获取totals字段？

核心解决方法 #

在GA4的RunReport请求中，必须显式添加returnTotals: true参数，才能让响应返回totals字段——GA3(UA)的batchGet接口默认返回总计，但GA4为了优化响应性能，默认不返回该字段，需要主动触发。

Postman请求示例（JSON格式） #

在请求体的顶层参数中加入配置即可，示例如下：

{
  "property": "properties/你的GA4属性ID",
  "dateRanges": [
    {
      "startDate": "2024-01-01",
      "endDate": "2024-01-31"
    }
  ],
  "metrics": [
    {
      "name": "activeUsers"
    },
    {
      "name": "sessions"
    }
  ],
  "dimensions": [
    {
      "name": "country"
    }
  ],
  "returnTotals": true
}

补充说明 #

添加该参数后，响应中的totals数组会包含所有请求指标的总计值，逻辑与GA3的总计字段一致，无需手动遍历数据行计算总和。

内容的提问来源于stack exchange，提问作者aljadepalaran