Google Ads API 具有统一的 属性检索和指标报告 机制 ，可让您使用 Google Ads 查询 语言创建查询。 这样一来，您就可以创建复杂的查询，以返回有关各个 Google Ads 账号的大量数据。
您可以使用 Search 或 SearchStream 方法创建查询。
这两种方法都支持相同的查询，并返回等效的结果。Search
方法以 10,000 行的固定大小页面返回数据，让您可以使用分页功能遍历结果集。例如，在低带宽或不可靠的网络条件下，将大型结果集分段为较小的响应，以便在连接丢失时重新获取，这可能很有优势。另一方面，SearchStream
方法会在单个响应中流式传输整个结果集，这对于批量数据检索来说可能更高效。
Search 和 SearchStream 都使用相同的基本网址：
https://googleads.googleapis.com/v25/customers/CUSTOMER_ID/googleAds
POST /v25/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 /v25/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 不需要 pageToken）：
POST /v25/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'" }