分頁結果

GoogleAdsService.Search 支援在要求中指定 page_size 來支援分頁。這會將查詢的結果集分割成多個回應，每個回應最多可包含 page_size 個物件數量。如果未指定 page_size，則將自動設為 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 個關鍵字，且 page_size 設為 1,000，則結果集在第一個回應中會包含 1,000 個 GoogleAdsRow 物件以及 next_page_token。

如要擷取下一千列，請使用相同頁面大小再次傳送要求，但請將要求的 page_token 更新為回應的 next_page_token。後續要求中的 page_size 值每次都可能不同。請注意，含有最後一批資料列的回應中不會填入 next_page_token。

我們的用戶端程式庫會自動處理分頁作業。您只需在整個回應的資料列中反覆執行這項作業。目前頁面中的所有資料列都傳回後，用戶端程式庫會自動代您擷取新的資料列，直到擷取整個資料集為止。如果使用 REST 而非 gRPC，則必須為每個新頁面明確發出要求。

Google Ads API 會在內部快取整個資料集，因此後續請求的速度會高於初始請求。您可以根據用途，將 page_size 設為 1 到 10,000 之間的任何值。一般來說，如要加快整體效能，請使用較大的 page_size 以減少往返次數。

您在後續要求中的查詢必須保持完全相同，才能充分運用快取資料，但這些要求不會計入配額，尤其是基本存取權。如果查詢有所不同，而且傳送時一併傳送相同的頁面符記，系統會傳回錯誤。