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

在 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 个。不过，建议操作不要超过 10000 次。
• 针对同一 AssetGroup 的单个批次的 AssetGroupListingGroupFilterOperation 操作不能超过 10000 次。
• 违反其中任一条件都会导致整个批量作业失败。