結果のページング

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 はデータセット全体を内部的にキャッシュするため、後続のリクエストは最初のリクエストよりも高速になります。

キャッシュされたデータを利用するには、以降のリクエストでもクエリはまったく同じでなければなりません。特にベーシック アクセスでは、リクエストは割り当て量に加算されません。クエリが異なり、同じページトークンとともに送信された場合は、エラーが返されます。