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"]
}