搜尋與 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'"
}