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
行の最後のバッチを含むレスポンスには取り込まれません。
レスポンスの行を繰り返すだけで、自動的にページングが処理されます。現在のページのすべての行が 返された場合、クライアント ライブラリは新しい行を自動的にフェッチします。 データセット全体を取得します。gRPC の代わりに REST を使用する場合は、新しいページごとにリクエストを明示的に行う必要があります。
Google Ads API はデータセット全体を内部的にキャッシュに保存するため、後続のリクエストは より高速になります
キャッシュされたデータを利用するには、以降のリクエストでもクエリはまったく同じでなければなりません。特にベーシック アクセスでは、リクエストは割り当て量に加算されません。もし クエリが異なり、同じページトークンとともに送信されると、エラーが返されます。