批量作业中的商品详情组过滤条件

在 AdGroupCriterion.listing_group 或 AssetGroupListingGroupFilter 的上下文中使用产品信息组过滤条件时，在设计集成时应考虑一些注意事项。

批量拆分

要点 ：我们建议将针对同一 AssetGroup 的 AssetGroupListingGroupFilterOperation 操作和包含针对同一 AdGroup 的 listing_group 的 AdGroupCriterionOperation 操作连续添加到批量作业中，以便在批量拆分期间以原子方式处理这组操作。

如果批量作业中有任何操作包含广告组条件或素材资源组产品信息组过滤条件，则 Google Ads API 服务器收到该批量作业的操作后，系统会将其拆分为多个子批次。请注意，与批量作业中的标准操作不同，系统以原子方式处理包含列出组过滤器操作的每个子批次。

将包含列表组过滤条件的批量作业拆分为子批次的方式取决于以下因素：

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

对于如何组合操作，请注意以下几点：

• 针对同一 AssetGroup 的所有连续 AssetGroupListingGroupFilterOperation 操作会组合在一个原子子批次中（没有部分失败行为）。
• 包含针对同一 AdGroup 的 listing_group 的所有连续 AdGroupCriterionOperation 操作都会被归为一个原子子批次（没有部分失败行为）。
• 所有其他连续操作按非原子子批次组合在一起（部分失败行为）。

关键术语 ：连续是指批量作业中的操作顺序。

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

限制

在批量作业的上下文中使用列表项组过滤条件时，需要遵循以下限制：

• 单批包含 listing_group 且定位到同一 AdGroup 的 AssetGroupListingGroupFilterOperation 操作的时长不得超过 20,000 次。不过，我们建议不要超过 10,000 次操作。
• 针对同一 AssetGroup 的单个批量 AssetGroupListingGroupFilterOperation 操作不能超过 10,000 个操作。
• 违反其中任一条件都会导致整个批量作业失败。