Google Search Console API 使用体验

Google Search Console API参考文档：https://developers.google.com/webmaster-tools/v1/searchanalytics/query?hl=zh-cn

API完整数据字段如下：

{
  "startDate": string,
  "endDate": string,
  "dimensions": [
    string
  ],
  "type": string,
  "dimensionFilterGroups": [
    {
      "groupType": string,
      "filters": [
        {
          "dimension": string,
          "operator": string,
          "expression": string
        }
      ]
    }
  ],
  "aggregationType": string,
  "rowLimit": integer,
  "startRow": integer
}

实际上上面有些字段平常用不到，常用字段如下：

{
  "startDate": string,
  "endDate": string,
  "dimensions": [
    string
  ],
  "dimensionFilterGroups": [
    {
      "groupType": string,
      "filters": [
        {
          "dimension": string,
          "operator": string,
          "expression": string
        }
      ]
    }
  ],
  "rowLimit": integer,
}

1，startDate: [必需] 所请求日期范围的开始日期，采用 YYYY-MM-DD 格式，采用 PT 时间 (UTC - 7:00/8:00) 来表示。必须小于或等于结束日期。该值包含在范围内。

2，endDate: [必需] 所请求日期范围的结束日期，采用 YYYY-MM-DD 格式，采用美国太平洋时间时间 (UTC - 7:00/8:00)。必须大于或等于开始日期。该值包含在范围内。

3，dimensions: 返回的字段，列表结构。一般选择"page","query","country"，分别对应GSC中的"网页","查询数(query)"，"国家/地区"。

4，dimensionFilterGroups[].filters[].operator:[可选] 您指定的值必须与该行的维度值匹配（或不匹配）。

这个就是我们的筛选条件，

可接受的值为：

“contains”：行值必须包含或等于您的表达式（不区分大小写）。

  "equals": [默认] 您的表达式必须完全等于行值（对于网页维度和查询维度，区分大小写）。

“notContains”：行值不得包含子字符串或（不区分大小写）完全匹配形式的表达式。

“notEquals”：您的表达式不得与行值完全相同（对于网页维度和查询维度，区分大小写）。

“includingRegex”：必须匹配的 RE2 语法正则表达式。

“excludingRegex”： RE2 语法正则表达式，不得匹配。

5，rowLimit: [可选；有效范围为 1–25,000；默认值为 1,000] 要返回的行数上限。如需对结果进行分页，请使用 startRow 偏移。

Google Search Console API可以有无限的想象空间，可以帮助我们查询到用户通过Google搜索访问网站的大部分数据，而且这部分是Google Analytics给不了的。

举例：

查询1月9日用户是通过搜索什么关键词进入包含"saudi-arabia"页面，返回前2000条数据；

{
    "startDate": "2024-01-09",
    "endDate": "2024-01-09",
    "dimensions": ["page","query","country"],
    "dimensionFilterGroups": [
        {
            "filters": [
                {
                    "dimension": "page",
                    "operator": "contains",
                    "expression": "saudi-arabia"
                }
            ]
        }
    ],
    "rowLimit": 2000,
}

返回数据如下：