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

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

批量拆分

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

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

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

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

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

示意图,显示了分组为子批次的批处理操作

限制

在批量作业的上下文中处理产品信息组过滤条件时,适用以下限制:

问题排查

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

例如,在处理 ListBatchJobResults的响应时:

这些错误表明,该索引处的操作已回滚,因为同一原子子批次中的另一个操作失败。如需找出问题的根本原因,请针对共享同一 AdGroup 或 AssetGroup ID 的操作,遍历每个 BatchJobResult 中的 status 消息(事务错误的 operation_index之前和之后)。