ほとんどのサービスでは同期 API が提供されますが、リクエストを送信してレスポンスを待つ必要があります。BatchJobService
では、オペレーションの完了を待たずに、複数のサービスでオペレーションのバッチを実行できます。
サービス固有の変更オペレーションとは異なり、BatchJobService
内の 1 つのジョブは、キャンペーン、広告グループ、広告、条件、ラベル、フィード アイテムの組み合わせに対して機能します。送信されたジョブは並行して実行され、BatchJobService
は、レート制限エラーなどの一時的なエラーのために失敗したオペレーションを自動的に再試行します。Google Ads API では、API オペレーションのカウント方法に沿って、各オペレーションが 1 日あたりのオペレーション上限にカウントされます。
さらに、BatchJobService
では、リクエストで一時 ID を使用できるため、依存ジョブを 1 つのジョブで送信できます。
運用
BatchJobService
は、いくつかの重要な例外を除き、MutateOperation
にリストされているすべてのオペレーションをサポートします。
Google Ads API は、部分的失敗が有効になっているジョブ内のすべてのオペレーションを実行します。ただし、次の MutateOperation
のオペレーションはアトミックでなければならないため、部分的な失敗はサポートされません。そのため、バッチジョブ内ではサポートされていないため、ジョブに追加しないでください。
これらのオペレーションを実行する必要がある場合は、代わりに GoogleAdsService
の mutate
メソッドを使用して、リクエストで partial_failure
を false
に設定します。