搜尋與 AMP；SearchStream

Search Ads 360 報表 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'"
}