GoogleAdsService を使用したストリーミングを報告する

Google Ads API エンティティとレポートデータを取得するには、次のいずれかの方法を使用します。

2 つの方法の主な違いは次のとおりです。

GoogleAdsService.SearchStream GoogleAdsService.Search
本番環境コードに適している はい はい
サービス GoogleAdsService GoogleAdsService
シナリオ オブジェクトとレポートの取得 オブジェクトとレポートの取得
レスポンス GoogleAdsRow オブジェクトの Stream GoogleAdsRow オブジェクトのページ
レスポンスのフィールド クエリで指定されたもののみ クエリで指定されたもののみ
1 日の使用上限 アクセスレベルに基づく 1 日あたりの上限 アクセスレベルに基づく 1 日あたりの上限

Search は、レポート全体をダウンロードするために複数のページネーション リクエストを送信できますが、SearchStream は単一のリクエストを送信し、レポートのサイズに関係なく Google Ads API との永続的な接続を開始します。

SearchStream の場合、データ パケットはすぐにダウンロードを開始し、結果全体がデータ バッファにキャッシュ保存されます。コードは、ストリーム全体が終了するのを待たずに、バッファリングされたデータの読み取りを開始できます。

Search レスポンスの各ページをリクエストするために必要なネットワークの往復時間を排除することで、アプリによっては、SearchStream はページングよりもパフォーマンスを向上させることができます（特に大きなレポートの場合）。

例

この例では、100,000 行で構成されるレポートを見ています。次の表に、2 つの方法の会計上の違いを示します。

SearchStream 検索
ページサイズ 該当なし 1 ページあたり 10,000 行
API リクエストの数 1 件のリクエスト 10 件のリクエスト
API レスポンスの数 1 つの連続ストリーム 10 件の回答

パフォーマンスの要因

ほとんどのユースケースでは、次の理由から Search よりも SearchStream をおすすめします。

  • 単一ページのレポート（10,000 行未満）の場合: 2 つの方法の間にパフォーマンスの大きな違いはありません。

  • 複数ページのレポートの場合: SearchStream は通常、複数のラウンド トリップが回避され、ディスク キャッシュからの読み取りまたは書き込みが要因になりにくいため、高速です。

レート上限

両方のメソッドの 1 日あたりの上限は、開発者トークンの標準の上限とアクセスレベルに準拠します。結果がページングまたはストリーミングされているかどうかにかかわらず、1 つのクエリまたはレポートは 1 つのオペレーションとしてカウントされます。

前へ
ラベル
次へ
Paging