バッチ処理では、オペレーションの完了を同期的に待機することなく、相互に依存する可能性がある一連のオペレーションを複数のサービスにディスパッチする方法が提供されます。バッチ処理を使用して、P-MAX キャンペーンを作成、管理できます。
このガイドでは、バッチ処理を使用する場合の P-MAX キャンペーンに固有の詳細について説明します。一般的なバッチ処理ガイドでは、バッチ処理に関する一般的な情報を確認できます。リクエストの構造ガイドでは、P-MAX キャンペーンの作成または管理のためのリクエストの作成に関する詳細情報を確認できます。
バッチ処理を使用して P-MAX キャンペーンを作成する手順は次のとおりです。
新しいバッチジョブを作成する
一般的なバッチ処理のジョブ作成手順に沿って BatchJob リソースを作成します。
変更オペレーションのリストを準備する
P-MAX キャンペーンでは、関連する複数のリソースを作成するためのオペレーションが必要です。詳しくは、リクエストの構造に関するガイドをご覧ください。バッチジョブに含めるリソースごとに MutateOperation を作成します。
CampaignOperation と CampaignAssetOperation の要件
キャンペーンでブランド ガイドラインが有効になっている場合（ブランド ガイドラインを参照）、CampaignAsset リソースを使用してブランドアセットをキャンペーンにリンクする必要があります。さらに、バッチジョブでは、これらの CampaignAsset リソースの作成は Campaign リソース自体の作成直後に行う必要があります。Campaign リソースの直後に CampaignAsset リソースが作成されない場合（ブランド ガイドラインが有効になっている場合 - トラブルシューティングを参照）、リクエストは失敗し、アセットがないことを示す CampaignError が返されます。同じオペレーションのリストの後半に CampaignAsset 作成オペレーションを含めても、このエラーは回避されません。
AssetGroupOperation と AssetGroupAssetOperation の要件
バッチジョブで AssetGroup リソースと AssetGroupAsset リソースを作成する MutateOperation タイプのオペレーションは、処理時にこれらのオペレーションがグループ化されるため、間に他のオペレーションを入れずに順番に実行する必要があります。それ以外の場合、アセットの最小要件を満たすために必要なオペレーションが後でオペレーション リストに含まれていても、リクエストは一部のアセットが欠落していることを示す AssetGroupError をスローします。
AssetGroupListingGroupFilterOperation ベスト プラクティス
AssetGroupListingGroupFilter のコンテキストでリスティング グループ フィルタを使用する場合は、同じ AssetGroup をターゲットとする AssetGroupListingGroupFilterOperation オペレーションをバッチジョブに連続して追加することをおすすめします。これにより、バッチ分割中にオペレーションのセットが一括で処理されます。バッチ分割や掲載情報グループに影響するその他の要因について詳しくは、掲載情報グループのバッチ処理ガイドをご覧ください。
ジョブに変更オペレーションを追加する
ステップ 2 の変更オペレーションをリストに追加し、AddBatchJobOperations を呼び出して、ステップ 1 で作成したバッチジョブに変更リストを追加します。一般的なバッチ処理ガイドのオペレーションを追加する手順に沿って、変更オペレーションのリストを追加します。
バッチジョブを実行する
RunBatchJob を呼び出して、アップロードされたジョブの実行を開始します。例については、一般的なバッチ処理ガイドのバッチジョブを実行するの手順をご覧ください。
ジョブのステータスを取得する
バッチジョブは長時間実行オペレーションとして開始され、通常は完了までに時間がかかります。ジョブを開始したら、長時間実行オペレーションの GetOperation メソッドを使用して、完了するまでジョブのステータスをポーリングします。
すべてのバッチジョブが完了したら、ListBatchJobResults を呼び出して、一般的なバッチ処理ガイドのすべてのバッチジョブの結果を一覧表示するの手順に沿ってステータスとレスポンスを出力します。