在批次工作中列出群組篩選器

針對 AdGroupCriterion.listing_group 或 AssetGroupListingGroupFilter 使用商家資訊群組篩選器時，在設計整合時應考量下列幾點。

批次分割

重點提示： 我們建議將指定相同 AssetGroup 的 AssetGroupListingGroupFilterOperation 作業，以及指定相同 AdGroup 的 AdGroupCriterionOperation 作業連續新增至批次工作，以便在批次分割期間以不可分割的形式處理這組作業。

listing_group

如果批次工作中有任何作業包含廣告群組條件或素材資源群組商家資訊群組篩選條件，系統會在 Google Ads API 伺服器收到批次工作時，將批次工作中的作業拆分為多個「子批次」。請注意，有別於批次工作中的標準作業，包含清單群組篩選作業的每個子批次都會以不可分割的形式處理。

包含清單列表篩選器的批次工作會以何種方式分割成子批次，取決於下列因素：

1. 商家資訊群組篩選器的類型
2. 商家資訊群組篩選器指定的AdGroupCriterion或AssetGroup
3. 作業順序

請留意作業的分組方式：

• 凡是指定相同 AssetGroup 的連續 AssetGroupListingGroupFilterOperation 作業，都會以不可拆分的子批次 (無部分失敗行為) 分組。
• 包含 listing_group 指定相同 AdGroup 的所有連續 AdGroupCriterionOperation 作業，都會按不可分割的子批次 (無部分失敗行為) 分組。
• 所有其他連續作業都會以非不可拆分的子批次 (部分失敗行為) 分組。

重要詞彙： 連續是指批次工作中的作業順序。

下圖說明這個概念。每個灰色方塊都代表使用 Google Ads API 提交的批次工作。在灰色方塊中，個別作業會依顏色分類，代表 Google Ads API 伺服器建立的子批次。每個灰色方塊中的作業順序，會對應該作業新增至批次工作的順序。

限制

在批次工作環境中使用列出群組篩選器時，會受到下列限制：

• 單一批次包含 listing_group 且指定同一個 AdGroup 的 AssetGroupListingGroupFilterOperation 作業長度不得超過 20,000 項作業。不過，建議不要超過 10,000 個作業。
• 單一批次指定相同 AssetGroup 的 AssetGroupListingGroupFilterOperation 作業不得超過 10,000 項作業。
• 違反上述任一條件會導致整個批次工作失敗。