Search Ads 360 Reporting API 提供整合式屬性擷取和指標報表 機制 可讓您使用 Search Ads 360 查詢 語言。 因此,複雜查詢可能會傳回大量關於 個別 Search Ads 360 帳戶。
您可以使用 Search
或 SearchStream
方法建立查詢。
這兩種方法支援相同的查詢並傳回對等的結果。
Search
方法會以可自訂頁面大小傳回資料,方便您疊代
對結果集使用分頁在低頻寬時,這可能尤其適合
或不可靠的網路狀況,例如區隔大型結果集
轉成較小的回應,可在連線中斷時重新擷取。
另一方面,SearchStream
方法會將整個結果集串流回
單一回應,因此能更有效率地擷取大量資料。
Search
和 SearchStream
使用相同的基準網址:
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
未要求pageSize
和pageToken
):
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'" }