Search Analytics

如需本資源的方法清單，請見本頁結尾。

資源表示法

這項資源沒有任何相關聯的長存資料。

方法

查詢

使用您定義的篩選器和參數查詢搜尋流量資料。此方法會傳回零或多個依據您定義的資料列索引鍵 (維度) 分組的資料列。您必須定義一或多天的日期範圍。

以日期做為維度之一時，結果清單會省略任何沒有資料的日期。如要瞭解哪幾天有資料，請針對所需的日期範圍，提交不含依日期分組篩選器的查詢。

結果按點擊次數遞減排序。如果兩個資料列的點擊次數相同，就會以任意方式排序。

請參閱 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"]
}