搜尋與 AMP;SearchStream

Search Ads 360 Reporting API 提供整合式屬性擷取和指標報表 機制 可讓您使用 Search Ads 360 查詢 語言。 因此,複雜查詢可能會傳回大量關於 個別 Search Ads 360 帳戶。

您可以使用 SearchSearchStream 方法建立查詢。 這兩種方法支援相同的查詢並傳回對等的結果。 Search 方法會以可自訂頁面大小傳回資料,方便您疊代 對結果集使用分頁在低頻寬時,這可能尤其適合 或不可靠的網路狀況,例如區隔大型結果集 轉成較小的回應,可在連線中斷時重新擷取。 另一方面,SearchStream 方法會將整個結果集串流回 單一回應,因此能更有效率地擷取大量資料。

SearchSearchStream 使用相同的基準網址:

    https://searchAds360.googleapis.com/v0/customers/CUSTOMER_ID/searchAds360

網頁式搜尋方法採用選用的 pageSize 參數,可限制 單一 API 回應傳回的結果數量。

POST /v0/customers/CUSTOMER_ID/searchAds360:search HTTP/1.1
Host: searchAds360.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN

{
"pageSize": 10000,
"query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'"
}

如果結果中的資料列多於 pageSize 列,則 nextPageToken 是 :

{
  "results": [
    // ...
    // ...
    // ...
  ],
  "nextPageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B",
  "fieldMask": "adGroupCriterion.keyword.text,adGroupCriterion.status"
}

重複相同的查詢,並加入 pageToken 並將上述值擷取到 下一頁的結果:

POST /v0/customers/CUSTOMER_ID/searchAds360:search HTTP/1.1
Host: searchads360.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN


{
"pageSize": 10000,
"query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'",
"pageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B"
}
敬上

如要使用 SearchStream 方法,這個方法會傳回單一串流中的所有結果 回應,只需將網址中的服務方法變更為 searchStream 即可 (SearchStream 未要求pageSizepageToken):

POST /v0/customers/CUSTOMER_ID/searchAds360:searchStream HTTP/1.1
Host: searchads360.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN

{
    "query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'"
}
敬上