Google Search Console API无法返回汇总数据问题求助

当你通过dimensionFilterGroups设置查询包含过滤，同时指定dimensions: ["MYQUERY"]时，API默认仅返回匹配条件的查询明细行，不会自动生成汇总数据。CoPilot提到的responseAggregationTypeRows字段并非官方API的响应结构，属于错误提示。

解决方法 #

在请求payload中添加totalsRow: true参数，即可让API返回过滤后的汇总数据（总点击量、总展示量、平均点击率、平均排名）。

修正后的请求Payload #

payload = {
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "dimensions": ["MYQUERY"],
  "dimensionFilterGroups": [
    {
      "filters": [
        {
          "dimension": "query",
          "operator": "contains",
          "expression": "query"
        }
      ]
    }
  ],
  "responseAggregationType": "byProperty",
  "totalsRow": true  # 开启汇总行返回
}

响应示例（包含汇总数据） #

{'rows': [{'keys': ['Query 1'],
   'clicks': 52,
   'impressions': 83,
   'ctr': 0.6265060240963856,
   'position': 1.072289156626506},
  {'keys': ['Query 2'],
   'clicks': 7,
   'impressions': 2883,
   'ctr': 0.002428026361429067,
   'position': 46.153659382587584},
  ...],
 'responseAggregationType': 'byProperty',
 'totals': {
   'clicks': 61,
   'impressions': 2968,
   'ctr': 0.02055256064690027,
   'position': 42.87601078167116
 }}

额外说明 #

• responseAggregationType仅控制数据的聚合范围（按属性、页面等），不影响汇总行的生成；
• 若仅需汇总数据，可移除dimensions参数，此时API会直接返回totals字段，无明细行；
• 若需同时保留明细和汇总，保持dimensions并开启totalsRow: true即可。

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