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