バッチ
互換性のないディメンションと指標を使用している場合や、異なる方法でデータを集計する場合などは、必要な情報をすべて 1 つのレポートから得ることができない場合があります。
このような場合は、複数のレポートを作成する必要があります。
また、バッチ処理は、リクエスト数を減らしてアプリのパフォーマンスを改善する効果的な方法です。
複数の独立したリクエストを行う場合の問題
実装はシンプルな解決策ですが、短時間で複数の API リクエストを行うと、割り当て制限に達する場合があります。
より優れた解決策は、並列リクエストを完全に避け、代わりにバッチ リクエストを作成することです。
レポートのバッチ処理
ユーザー主導のアプリケーションの例では、最初のアプローチは、独立したリクエストをできるだけ多く 1 つのバッチ リクエストにまとめることです。
レポート 1: 8 月の上位 10 か国
レポート 2: 7 月の上位 10 か国の値(比較用)
レポート 3: 8 月の上位 10 チャンネル
レポート 4: 7 月の上位 10 チャンネルの値(比較用)
上の例では、レポート 1 と 3 はそれぞれ独立していますが、データの内訳が異なるため、1 つのレポートにまとめることはできません。ただし、まとめてバッチ処理することはできます。
レポート 2 と 4 は、リクエストに適切なフィルタを設定する必要があるため、最初のバッチで結果を取得した後でのみ実行できます。最初のバッチの結果が届いたら、これを 2 番目のバッチとして実行できます。
すべてのリクエストを 1 つのバッチにまとめる別のオプションとして、上位 10 件だけではなく 7 月のすべての値を返し、場合によっては 8 月もすべて返します。問題の AdSense アカウントの規模やアプリケーションで使用可能なメモリ量によっては、この方法が妥当な場合もあります。
仕組み
バッチ処理の処理方法はクライアント ライブラリごとに異なるため、詳細はクライアント ライブラリのドキュメントをご覧ください。いくつかのクライアント ライブラリの関連ドキュメントへのリンクを以下に示します。
次のステップ
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2024-08-22 UTC。
[null,null,["最終更新日 2024-08-22 UTC。"],[[["Batching requests improves app performance by reducing the number of API calls and mitigating quota limitations."],["Independent reports, like those with incompatible dimensions or metrics, can be combined into batch requests."],["Batching can involve grouping related reports or retrieving broader data sets to minimize the total number of batches."],["Specific batching implementations vary by client library (.NET, PHP, Python, Java, Ruby, etc.)."],["For handling very large reports or incompatible dimensions and metrics, refer to the provided resources for further guidance."]]],["When single reports can't provide all necessary data due to incompatible dimensions or different aggregation needs, multiple reports are required. Batching multiple API requests improves app performance and reduces quota limitations, avoiding parallel requests. Independent requests, like retrieving top countries and channels, can be combined into a single batch. Subsequent requests for comparison data can be batched afterward, once the initial batch results are available. Client libraries offer varied methods for batching, requiring consultation of their respective documentation.\n"]]