在 AdGroupCriterion.listing_group
或 AssetGroupListingGroupFilter
的上下文中使用产品信息组过滤条件时,在设计集成时应考虑一些注意事项。
批量拆分
如果批量作业中有任何操作包含广告组条件或素材资源组产品信息组过滤条件,则 Google Ads API 服务器收到该批量作业的操作后,系统会将其拆分为多个子批次。请注意,与批量作业中的标准操作不同,系统以原子方式处理包含列出组过滤器操作的每个子批次。
将包含列表组过滤条件的批量作业拆分为子批次的方式取决于以下因素:
- 产品信息组过滤条件的类型
- 产品信息组过滤条件定位的
AdGroupCriterion
或AssetGroup
- 操作顺序
对于如何组合操作,请注意以下几点:
- 针对同一
AssetGroup
的所有连续AssetGroupListingGroupFilterOperation
操作会组合在一个原子子批次中(没有部分失败行为)。 - 包含针对同一
AdGroup
的listing_group
的所有连续AdGroupCriterionOperation
操作都会被归为一个原子子批次(没有部分失败行为)。 - 所有其他连续操作按非原子子批次组合在一起(部分失败行为)。
下图说明了这一概念。每个灰色方框均表示使用 Google Ads API 提交的批量作业。在灰色框中,各个操作按颜色分组,表示 Google Ads API 服务器创建的子批次。每个灰色框中的操作顺序都对应于将操作添加到批量作业中的顺序。
限制
在批量作业的上下文中使用列表项组过滤条件时,需要遵循以下限制:
- 单批包含
listing_group
且定位到同一AdGroup
的AssetGroupListingGroupFilterOperation
操作的时长不得超过 20,000 次。不过,我们建议不要超过 10,000 次操作。 - 针对同一
AssetGroup
的单个批量AssetGroupListingGroupFilterOperation
操作不能超过 10,000 个操作。 - 违反其中任一条件都会导致整个批量作业失败。