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