バッチ処理では、相互依存性がある一連のオペレーションを、オペレーションの完了を同期的に待たずに複数のサービスにディスパッチできます。バッチ処理を使用すると、P-MAX キャンペーンを作成して管理できます。
このガイドでは、バッチ処理を使用する P-MAX キャンペーンに固有の詳細情報について説明します。一般的なバッチ処理ガイドにはバッチ処理に関する一般的な情報が記載されています。また、リクエストの構成ガイドには、P-MAX キャンペーンを作成または管理するためのリクエストの作成に関する詳細情報が記載されています。
バッチ処理を使用して P-MAX キャンペーンを作成する手順は次のとおりです。
新しいバッチジョブを作成する
BatchJob リソースを作成するには、一般的なバッチ処理のジョブ作成手順に従います。
変換オペレーションのリストを準備する
P-MAX キャンペーンでは、複数の関連リソースを作成するオペレーションが必要です。詳細については、リクエストの構成ガイドをご覧ください。バッチジョブに含めるリソースごとに MutateOperation を作成します。
AssetGroupOperation と AssetGroupAssetOperation の要件
バッチジョブに AssetGroup リソースと AssetGroupAsset リソースを作成する MutateOperation タイプのオペレーションは、他のオペレーションが間に挟まらずに連続している必要があります。これは、これらのオペレーションが処理時にグループ化される仕組みによるものです。そうでない場合、リクエストは一部のアセットが不足していることを示す AssetGroupError をスローします。アセットの最小要件を満たすために必要なオペレーションがオペレーション リストの後半に含まれていても問題ありません。
AssetGroupListingGroupFilterOperation 件のベスト プラクティス
AssetGroupListingGroupFilter のコンテキストでリスティング グループのフィルタを使用する場合は、同じ AssetGroup を対象とする AssetGroupListingGroupFilterOperation オペレーションをバッチジョブに連続して追加することをおすすめします。これにより、バッチ分割中に一連のオペレーションがアトミックに処理されるようになります。一括分割や、リスティング グループに影響するその他の要因の詳細については、リスティング グループのバッチ処理ガイドをご覧ください。
変換オペレーションをジョブに追加する
ステップ 2 の変更オペレーションをリストに追加し、AddBatchJobOperations を呼び出して、ステップ 1 で作成したバッチジョブにミューテーションのリストを追加します。変換オペレーションのリストを追加するには、一般的なバッチ処理ガイドのオペレーションを追加する手順に従ってください。
バッチジョブを実行する
RunBatchJob を呼び出して、アップロードされたジョブの実行を開始できるようにします。例については、一般的なバッチ処理ガイドのバッチジョブを実行するステップをご覧ください。
ジョブのステータスを取得する
バッチジョブは長時間実行オペレーションとして開始され、通常は完了までに時間がかかります。ジョブを開始したら、長時間実行オペレーションの GetOperation メソッドを使用して、ジョブが完了するまでジョブのステータスをポーリングします。
すべてのバッチジョブが終了したら、一般的なバッチ処理ガイドのすべてのバッチジョブの結果を一覧表示するの手順に沿って、ListBatchJobResults を呼び出してステータスとレスポンスを出力します。