逐頁瀏覽結果

注意： Google Ads API 第 19 版已移除 page_size 欄位。請參閱公告。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 會在內部快取整個資料集，因此後續要求會比初始要求更快。

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

重點： 如需手動分頁 (例如自訂網頁分頁)，建議您在本機 (例如資料庫) 擷取及儲存結果，並自行建構分頁邏輯。