分頁結果

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 來減少來回次數。

您在後續要求中的查詢必須完全相同,才能使用快取資料;這些要求並不會計入您的配額,特別是針對基本存取權。如果查詢不同,並伴隨相同的頁面符記傳送,系統會傳回錯誤。