分頁結果

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 ,您就必須為每個新網頁明確發出要求。

Google Ads API 會在內部快取整個資料集,因此後續請求 比初始圖片快

您在後續要求中的查詢必須保持不變,才能充分運用 快取資料;這些要求不會計入配額 特別是基本存取權。如果 是不同的查詢,隨著相同的網頁符記傳送,系統會傳回錯誤。