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
以減少往返次數。
您在後續要求中的查詢必須保持完全相同,才能充分運用快取資料,但這些要求不會計入配額,尤其是基本存取權。如果查詢有所不同,而且傳送時一併傳送相同的頁面符記,系統會傳回錯誤。