分頁結果

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

後續要求中的查詢必須與前述完全相同，才能充分利用快取資料；這些要求不會影響配額，尤其是基本存取權。如果查詢不同，且傳送時會附上相同的網頁權杖，系統會傳回錯誤。