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

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

在AdGroupCriterion.listing_group 或 AssetGroupListingGroupFilter 的上下文中使用商家資訊群組篩選器時，設計整合功能時應考量幾點。

批次拆分

如果批次作業包含廣告群組條件或素材資源群組刊登群組篩選器，Google Ads API 伺服器收到這些作業時，會將作業分割成多個子批次。請注意，與批次作業中的標準作業不同，包含資訊群組篩選作業的每個子批次都會以原子方式處理。

含有商家資訊群組篩選器的批次工作如何拆分為子批次，取決於下列因素：

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

請注意下列作業分組方式：

• 針對相同 AssetGroup 的所有連續 AssetGroupListingGroupFilterOperation 作業會在單一原子子批次中歸為一組 (不會出現部分失敗行為)。
• 所有連續的 AdGroupCriterionOperation 作業，如果包含以相同 AdGroup 為目標的 listing_group，就會在不可分割的子批次中分組 (不會發生部分失敗行為)。
• 所有其他連續作業會以非原子子批次 (部分失敗行為) 分組。

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

限制

在批次工作中使用產品資訊群組篩選器時，請注意下列限制：

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

疑難排解

在批次工作中，系統會將清單群組篩選器作業處理為單一交易，這可能導致因少數錯誤作業而導致多個作業失敗的情況。此外，由於 BatchJob 作業的處理方式，故障的根本原因可能會出現在下游故障之前或之後的索引。

舉例來說，處理 ListBatchJobResults 的回應時，您可能會發現有幾項作業失敗，並顯示狀態訊息 Ad group is invalid due to the listing groups it contains。這則訊息通常表示這個索引的作業已取消，因為其他索引的作業失敗。如要找出問題的根本原因，建議您逐一檢查 BatchJobResult 中的所有狀態訊息，包括 Ad group is invalid 錯誤訊息索引之前和之後的部分，以便搜尋其他錯誤資訊。