Search Analytics

如需了解此资源的方法列表，请参阅本页结尾部分。

资源表示形式

没有与此资源关联的持久性数据。

方法

query

使用您定义的过滤器和参数查询搜索流量数据。该方法会返回按您定义的行键（维度）分组的零行或零个以上行。您必须将日期范围定义为一天或多天。

如果日期是维度之一，则结果列表中会忽略所有没有数据的日期。如需了解哪些日期有数据，请针对相关日期范围发出不含按日期分组的过滤条件的查询。

结果按点击次数降序排序。如果两行的点击计数相同，则会以任意方式对其进行排序。

如需了解如何调用此方法，请参阅 python 示例。

该 API 受 Search Console 内部限制的限制，无法保证返回所有数据行，而是返回热门数据行。

查看可用数据量的限制。

JSON POST 示例：

POST https://www.googleapis.com/webmasters/v3/sites/https%3A%2F%2Fwww.example.com%2F/searchAnalytics/query?key={MY_API_KEY}
{
  "startDate": "2015-04-01",
  "endDate": "2015-05-01",
  "dimensions": ["country","device"]
}