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