逐頁瀏覽結果

您可以透過 GoogleAdsService.Search 逐頁瀏覽擷取的結果，不必一次下載整個結果集。如要瞭解如何使用 Google Ads API 產生報表，請參閱報表指南。

結果會分成多頁傳回，每頁最多 10,000 列。如果要求中未設定 page_size，則預設值為 10,000。如果 page_size 設為大於 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 會在內部快取整個資料集，因此後續要求會比初始要求更快。

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