适用于效果最大化广告系列的批处理

批量处理提供了一种将一组可能相互依赖的操作分派给多个服务的方法，而无需同步等待操作完成。您可以使用批量处理来创建和管理效果最大化广告系列。

本指南详细介绍了在进行批量处理时，效果最大化广告系列的具体情况。通用批量处理指南提供了有关批量处理的一般信息，而构建请求指南则包含有关如何构建请求以创建或管理效果最大化广告系列的详细信息。

如需使用批量处理功能制作效果最大化广告系列，请按以下步骤操作：

创建新的批处理作业

按照创建 BatchJob 资源的一般批量处理作业创建步骤操作。

准备一系列 mutate 操作

效果最大化广告系列需要执行多项操作才能创建多个相关资源，详情请参阅结构化请求指南。为应包含在批处理作业中的每项资源创建一个 MutateOperation。

CampaignOperation 和 CampaignAssetOperation 要求

注意： 此要求仅适用于具有关联 Asset 资源且使用 CampaignAsset 的 Campaign 资源，以满足品牌资产要求。

如果为广告系列启用了品牌推广指南（请参阅品牌推广指南），您必须使用 CampaignAsset 资源将品牌推广素材资源与广告系列相关联。此外，在批处理作业中，这些 CampaignAsset 资源的创建必须在 Campaign 资源本身创建后立即进行。如果 Campaign 资源创建后未立即创建 CampaignAsset 资源（启用品牌推广指南时 - 请参阅问题排查），请求将失败并返回 CampaignError，表明缺少素材资源。即使在同一操作列表中稍后添加 CampaignAsset 创建操作，也不会阻止此错误。

AssetGroupOperation 和 AssetGroupAssetOperation 要求

注意： 此要求仅适用于具有关联 Asset 资源且使用 AssetGroupAsset 的 AssetGroup 资源，以便遵守最低资源要求。

在批处理作业中创建 AssetGroup 和 AssetGroupAsset 资源的 MutateOperation 类型操作必须是连续的，中间不能有其他操作，因为这些操作在处理时会分组在一起。否则，即使操作列表中稍后包含满足最低素材资源要求所需的操作，请求也会抛出 AssetGroupError，表明缺少某些素材资源。

AssetGroupListingGroupFilterOperation 最佳实践

注意： AssetGroupListingGroupFilter 资源只能用于以提高线上销售额为目标且使用商品 Feed 的效果最大化广告系列。 此类广告系列中的 AssetGroup 资源必须具有由一个或多个 AssetGroupListingGroupFilter 资源组成的有效产品组树。如需定位所有商品，请使用单个节点树。

在 AssetGroupListingGroupFilter 的上下文中处理商品详情组过滤条件时，建议将针对同一 AssetGroup 的 AssetGroupListingGroupFilterOperation 操作连续添加到批处理作业中，以便在批处理拆分期间将这组操作视为原子操作。如需详细了解批次拆分以及影响商品详情组的其他因素，请参阅商品详情组批处理指南。

将变异操作添加到作业中

将第 2 步中的 mutate 操作添加到一个列表，然后调用 AddBatchJobOperations，以将突变列表添加到第 1 步中创建的批处理作业。按照常规批量处理指南中的添加操作步骤添加 mutate 操作列表。

运行批处理作业

通过调用 RunBatchJob 允许上传的作业开始运行。如需查看示例，请参阅常规批量处理指南中的运行批处理作业步骤。

检索作业的状态

批量作业会以长时间运行的操作开始，通常需要一段时间才能完成。 开始作业后，使用长时间运行的操作的 GetOperation 方法轮询作业的状态，直到作业完成。

当所有批处理作业完成后，请按照常规批处理指南中的列出所有批处理作业结果步骤，调用 ListBatchJobResults 以打印其状态和响应。