GoogleAdsService.Search
支持
以 10,000 行的固定页面大小进行分页。查询结果集会拆分
每个响应包含 10,000 个对象。
例如,对于以下查询:
SELECT
ad_group.id,
ad_group_criterion.type,
ad_group_criterion.criterion_id,
ad_group_criterion.keyword.text,
ad_group_criterion.keyword.match_type
FROM ad_group_criterion
WHERE ad_group_criterion.type = KEYWORD
如果您的账号包含 50,000 个关键字,则结果集将包含 10,000 个
第一个响应中 GoogleAdsRow
对象,
以及 next_page_token
。
要检索接下来的 10,000 行,请再次发送请求,但更新
将请求的 page_token
添加到响应的
next_page_token
。
请注意,next_page_token
在包含最后一批行的响应中未填充 。
我们的客户端库会自动处理分页。您只需遍历响应的行即可。如果当前页面中的所有行都有 客户端库会自动在 直到检索到整个数据集。如果使用 REST 取代 gRPC,那么您必须对每个新的页面明确地发出请求。
Google Ads API 在内部缓存整个数据集, 速度要比最初的速度快
您的查询必须在后续请求中完全保持不变,才能利用缓存的数据;这些请求不会对您的配额产生影响,对于基本访问权限而言,尤其如此。如果 与同一页面令牌一起发送,则会返回错误。