Search Analytics API 现已支持每小时数据

2025 年 4 月 9 日,星期三

几个月前,我们宣布改进了在 Search Console 中查看近期效果数据的方式。“24 小时”视图包含过去 24 小时内可用的数据,并且只会延迟几个小时。此视图可帮助您了解哪些网页和查询在最近这段时间的表现良好,以及您最近发布的内容如何表现更好。

今天,我们将向 Search Analytics API 中添加对每小时数据的支持,因为我们听到了生态系统的请求,希望让此类数据更易于获取。因此,我们将向 API 添加每小时数据,并扩大范围,使其超出产品界面的范围:虽然产品仅显示过去 24 小时的每小时数据,而 API 将返回长达 10 天的数据,并按小时细分。这样一来,开发者不仅可以创建解决方案来显示最新日期的每小时数据,还可以将最新日期与前一周的同一天进行比较,这在分析每周各天的数据模式时非常有用。

如何从 Search Analytics API 中提取每小时数据

为了在 Search Analytics API 中提供每小时数据,我们对 API 请求正文进行了 2 项更改:

  • 新建了一个名为 HOURApiDimension,以便您按小时对响应进行分组。
  • 新的 dataState 值,名为 HOURLY_ALL,应在按小时分组时使用。这表示每小时数据可能不完整。

在下一部分中,我们提供了示例 API 请求和示例响应供您参考。

API 请求示例

{
  "startDate": "2025-04-07",
  "endDate": "2025-04-07",
  "dataState": "HOURLY_ALL",
  "dimensions": [
    "HOUR"
  ]
}

API 响应示例

{
  "rows": [
    {
      "keys": [
        "2025-04-07T00:00:00-07:00"
      ],
      "clicks": 17610,
      "impressions": 1571473,
      "ctr": 0.011206046810858348,
      "position": 10.073871456906991
    },
    {
      "keys": [
        "2025-04-07T01:00:00-07:00"
      ],
      "clicks": 18289,
      "impressions": 1662252,
      "ctr": 0.011002543537321658,
      "position": 9.5440029550272758
    },
    {
      "keys": [
        "2025-04-07T02:00:00-07:00"
      ],
      "clicks": 18548,
      "impressions": 1652038,
      "ctr": 0.011227344649457216,
      "position": 9.81503633693656
    },
    {
      "keys": [
        "2025-04-07T03:00:00-07:00"
      ],
      "clicks": 18931,
      "impressions": 1592716,
      "ctr": 0.01188598595104212,
      "position": 9.4956935197486558
    },
    {
      "keys": [
        "2025-04-07T04:00:00-07:00"
      ],
      "clicks": 20519,
      "impressions": 1595636,
      "ctr": 0.012859449147549943,
      "position": 9.4670100198290843
    },
    
  ],
  "responseAggregationType": "byProperty"
}

我们希望,借助这些新数据,您可以更有效地监控最近发布的内容,并在适用情况下及时采取行动。我们非常希望了解您对这种新视图的看法,以及您对如何改进该视图的任何建议。如果您有任何反馈、问题或意见,可以通过 LinkedIn 与我们联系,或在 Google 搜索中心社区中发帖。