バッチ処理

ほとんどのサービスは、リクエストを送信してレスポンスを待つ必要がある同期 API を提供していますが、BatchJobServiceを使用すると、オペレーションの完了を同期的に待つことなく、複数のサービスに対して一連のオペレーションを実行できます。

サービス固有の mutate オペレーションとは異なり、 BatchJobService の 1 つのジョブで、キャンペーン、広告グループ、広告、条件、ラベル、フィード アイテムの混合 コレクションに対してオペレーションを実行できます。 送信されたジョブは並行して実行され、 BatchJobServiceは、レート制限エラーなどの一時的なエラーが原因で失敗したオペレーションを自動的に再試行します。Google Ads API は、API オペレーションのカウントに関する手順に沿って、各オペレーションを 1 日のオペレーション上限にカウントします。

BatchJobService を使用すると、リクエスト内で 一時 ID を使用して、 依存するオペレーションを 1 つのジョブで送信できます。

オペレーション

BatchJobService は、 MutateOperation に記載されているすべてのオペレーションをサポートしています。ただし、いくつかの重要な 例外があります。

Google Ads API は、部分的な失敗が有効になっているジョブ内のすべてのオペレーションを実行するため、ジョブがキャンセルされた場合や個々のオペレーションが失敗した場合でも、成功したオペレーションはロールバックされません。

MutateOperation の次のオペレーションは アトミックである必要があるため、部分的な失敗をサポートしておらず、 バッチジョブ内ではサポートされていません。これらのオペレーションを ジョブに追加しないようにし、リクエストで partial_failurefalse に設定して、代わりに mutate メソッドを GoogleAdsService で使用してください。

BatchJobService でサポートされていないオペレーション