在批量作业中使用产品信息组过滤条件

在 AdGroupCriterion.listing_group 或 AssetGroupListingGroupFilter 的上下文中处理产品信息组过滤条件时，请在设计集成时考虑以下事项。

批次拆分

要点： 建议将定位到同一 AssetGroup 的 AssetGroupListingGroupFilterOperation 操作（create、update 和 remove）和针对同一 AdGroup 的 LISTING_GROUP 条件（AdGroupCriterion.listing_group）的 AdGroupCriterionOperation 操作（create、update 和 remove）连续添加到批量作业中，以便在批量拆分期间以原子方式处理该组操作。

如果批量作业中包含任何广告组条件或素材资源组产品信息组过滤条件，则当 Google Ads API 服务器收到该批量作业时，其中的操作会被拆分为多个子批次。与批处理作业中的标准操作不同，包含商品详情组过滤操作的每个子批次都会被视为原子操作。

包含产品信息组过滤条件的批量作业拆分为子批次的方式取决于以下因素：

1. 产品信息组过滤条件的类型
2. AdGroup 或 AssetGroup 产品信息组过滤条件所定位到的
3. 操作顺序

考虑如何对操作进行分组：

• 针对同一 AssetGroup 的所有连续 AssetGroupListingGroupFilterOperation 操作（create、update 和 remove）都将分组到原子子批次中（不会出现部分失败行为）。
• 对于以同一 AdGroup 为目标的 LISTING_GROUP 条件 (AdGroupCriterion.listing_group)，所有连续的 AdGroupCriterionOperation 操作（create、update 和 remove）都将分组到一个原子子批次中（不会出现部分失败行为）。
• 所有其他连续操作都将分组到非原子子批次中（部分失败行为）。

注意： 如果您还在同一批处理作业中创建 AssetGroup，请将新 Asset 资源的所有前提条件 AssetOperation (create) 操作放在 AssetGroupOperation (create) 之前，紧随其后的是其 AssetGroupAssetOperation (create) 操作（这些操作会在前面的原子子批处理中一起执行），然后是连续的 AssetGroupListingGroupFilterOperation 操作（这些操作会在下一个原子子批处理中执行）。由于这些操作构成两个单独的子批次，因此 AssetGroupListingGroupFilterOperation 子批次中的失败会回滚商品详情组过滤条件，而不会回滚新创建的 AssetGroup 和 AssetGroupAsset 资源。

关键术语： 连续是指批处理作业中操作的顺序。如果以同一 AdGroup 或 AssetGroup 为目标的操作与以其他组为目标的操作交错，则这些操作会拆分为单独的子批次，不再作为单个原子事务进行处理。

下图展示了这一概念。每个灰色框都表示使用 Google Ads API 提交的批量作业。在灰色框内，各个操作按颜色分组，表示 Google Ads API 服务器创建的子批次。每个灰色框中的操作顺序与这些操作添加到批量作业中的顺序相对应。

限制

在批量作业中处理产品信息组过滤条件时，存在以下限制：

• 针对同一 AdGroup 的连续 AdGroupCriterionOperation 操作（create、update 和 remove）的单个原子子批次（AdGroupCriterion.listing_group）不能超过 20,000 个操作。LISTING_GROUP 条件不过，建议不要超过 10,000 次操作。由于每个 AddBatchJobOperationsRequest 的上限为 10,000 次操作，因此包含 10,001 至 20,000 次操作的 AdGroup 子批次必须通过至少两个连续的 AddBatchJobOperations 请求上传。
• 针对同一 AssetGroup 的连续 AssetGroupListingGroupFilterOperation 操作（create、update 和 remove）的单个原子子批次不得超过 10,000 次操作。
• 如果违反了上述任一操作数限制（或超出服务器针对单个子批次的内部序列化字节大小限制），系统会中止相应子批次的批处理作业：之前已完成的任何子批次仍会保持提交状态，而违规子批次中的所有操作以及任何后续子批次都会失败，并显示 InternalError.INTERNAL_ERROR。

问题排查

批量作业中的产品信息组过滤条件操作会作为一项事务进行处理，这可能会导致因少量错误操作而导致许多操作失败。此外，由于 BatchJob 操作的处理方式，故障的根本原因可能会出现在下游故障之前的索引处，也可能会出现在下游故障之后的索引处。

例如，在处理来自 ListBatchJobResults 的响应时：

• 对于 AdGroupCriterionOperation 商品详情组，您可能会发现，针对同一 AdGroup 的连续操作失败，并显示 CriterionError.LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION (Product group operations are atomic within the same ad group. This operation failed because another operation targeting the same ad group ID was invalid.)。
• 对于 AssetGroupListingGroupFilterOperation 操作，您可能会发现以同一 AssetGroup 为目标的连续操作失败，并显示 BatchJobError.ASSET_GROUP_LISTING_GROUP_FILTER_TRANSACTION_FAILURE。

这些错误表明，相应索引处的操作已回滚，因为同一原子子批次中的另一项操作失败。为了确定问题的根本原因，请针对共享相同 AdGroup 或 AssetGroup ID 的操作，遍历每个 BatchJobResult 中 status 消息（在交易错误 operation_index 之前和之后）。