逐頁瀏覽結果

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 會在內部快取整個資料集，因此後續要求會比初始要求更快。

後續要求中的查詢必須完全相同，才能使用快取資料。這些要求不會計入配額，尤其是探索存取層級和基本存取層級。如果查詢不同，但與同一頁面權杖一起傳送，系統就會傳回錯誤。