搜索和 SearchStream

Google Ads API 具有统一的属性检索和指标报告机制可让您使用Google Ads 查询语言。这支持复杂的查询，这些查询可返回大量关于 Google Ads 普通账号。

您可以使用 Search 或 SearchStream 方法创建查询。这两种方法支持相同的查询并返回等效的结果。通过 Search 方法以固定大小的页面（10,000 行）返回数据，让您能够使用分页功能遍历结果集。这种做法在处理带宽或网络条件不可靠等，例如将大量结果集转换为较小的响应，以便在连接网络后重新获取。另一方面，SearchStream 方法会流式传输整个结果设置在单个响应中，这对于批量数据更为高效检索。

Search 和 SearchStream 使用相同的基础网址：

    https://googleads.googleapis.com/v17/customers/CUSTOMER_ID/googleAds

POST /v17/customers/CUSTOMER_ID/googleAds:search HTTP/1.1
Host: googleads.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_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'"
}

如果结果中的行数超过 10,000，则 nextPageToken 返回的值：

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

通过添加 pageToken 的值重复同一查询，并添加来自上一个请求会提取下一页结果：

POST /v17/customers/CUSTOMER_ID/googleAds:search HTTP/1.1
Host: googleads.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_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'",
"pageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B"
}

使用 SearchStream 方法，该方法会在单个流式传输中返回所有结果请将网址中的服务方法更改为 searchStream （SearchStream 不需要 pageSize 和 pageToken）：

POST /v17/customers/CUSTOMER_ID/googleAds:searchStream HTTP/1.1
Host: googleads.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_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'"
}

概览

Mutate