将结果分页

注意： page_size 字段已在 Google Ads API 的 v19 中移除。请参阅公告。 page_size 字段的默认值为 10,000。请勿尝试设置 page_size 值，因为这会引发错误。

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 在内部缓存整个数据集，因此后续请求的速度会比初始请求快。

您的查询必须在后续请求中完全保持不变，才能利用缓存的数据。这些请求不会对您的配额产生影响，对于基本访问权限级别而言，尤其如此。如果查询发生变化，并且是与同一页面令牌一起发送的，则会返回错误。

重点： 如果您需要手动分页（例如用于自定义网页分页），建议您在本地（例如数据库中）检索并存储结果，然后构建自己的分页逻辑。