資產群組清單群組記錄 - 大量
定義可在大量檔案中上傳和下載的資產群組清單群組。
您可以在相同的大量檔案中上傳多個廣告群組的 資產群組清單群組 記錄，只要符合驗證規則，如下所述。
您至少必須指定產品資料分割群組樹狀結構的根節點。 產品分割區群組的根節點必須將其 [產品條件 1 ] 字段設定為 [全部] 和 [產品值 1 ] 為 Null 或空白。 如果您同樣地對目錄中的所有產品都抱抱心，請將 [子類型 ] 字段設定為 [單位]。 如果您要根據更特定的產品條件來分割報價，請將 [子類型 ] 字段設定為 [細分]、將 [父準則標識 符] 設定為 null 或空白，並將 [ 標識符] 設定為負值。 對於任何子節點，您都會使用負值作為 父準則標識 符。
根節點會被視為層級 0，而樹狀結構最多可以有 7 層深的分支。
根據上傳要求，每個廣告群組最多可以包含 20,000 個產品分割樹狀節點。 廣告群組的整個產品分割樹狀節點計數不能超過 20,000。
相同樹狀結構的產品分割樹狀節點 (相同的廣告群組) 必須在檔案中群組在一起。
在下載期間不保證產品數據分割節點的順序，而且父節點可能會在子節點之後提供;不過，相同廣告群組的所有節點都會群組在檔案中。
如果您要建立或修改樹狀結構，則父產品數據分割樹狀節點必須在子產品分割樹狀節點之前排序;不過，順序對於非結構化變更並不重要，例如更新報價。 例如，如果您想要在不新增、刪除或更新樹狀結構的情況下更新申請，則只需要上傳 [ 標識 符] 和 [ 父標識符] 字段。
若要更新 [產品條件 1]、[ 產品值 1 ] 或 [ 已排除 ] 欄位，您必須刪除現有的產品分割樹節點，並上傳新的產品分割樹節點，以取得新的標識符。
如果有任何動作失敗，可能已成功的所有剩餘動作也會失敗。
所有產品分割區節點新增和刪除動作都必須產生完整的樹狀結構。
從根節點到分支結尾的每個路徑都必須以分葉節點終止， (子類型=單位) 。 除非 [已 排除 ] 欄位為 TRUE，否則每個單位都必須有一個報價，這表示節點是負廣告群組準則。
每個細分必須至少有一個分葉節點在子分割條件的其餘部分進行比對，也就是使用與其同層級單位相同的操作數 (的) ，並設定其 產品值 1 null 或空白。
如果您要在父系或子系都不存在的多個層級中加入分割區，請使用負 int 值作為參考來識別父系。 例如，將父系的 [標識符] 和子系的 [ 父準則標識 符] 字段設定為相同的負值。 負數標識碼只在呼叫期間有效。 上傳結果檔案中會傳回每個成功新增廣告群組準則的唯一系統標識碼。
若要暫停任何產品分割區，您必須將廣告群組的 [ 狀態 ] 字段更新為 [暫停]，以暫停整個 廣告群組 。 您可以將 [營銷活動] 的 [ 狀態] 字 段更新為 [暫停]，以暫停整個 營銷活動 。
針對 [已刪除] 動作，您只需要指定 [標識符 ] 和 [父標識符]。
如果您刪除父系產品分割區，也會刪除其所有子系和子系。
您不能在分支中指定重複的產品條件。
您可以在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 服務要求中包含 AssetGroupListingGroups 的 DownloadEntity 值，以下載帳戶中的所有資產群組清單群組記錄。 此外，下載要求必須包含 EntityData 範圍。 如需大量服務的詳細資訊，包括最佳做法，請參閱 大量下載和上傳。
如果您使用適用於 .NET、Java 或 Python 的 Bing 廣告 SDK ，可以使用 BulkServiceManager 來上傳和下載 BulkAssetGroupListingGroup 物件來節省時間，而不是直接呼叫服務作業，並撰寫自定義程式代碼來剖析大量檔案中的每個字段。
針對 資產群組清單群組 記錄， 大量檔案架構中提供下列屬性欄位。
資產群組
資產群組清單群組所屬的資產組名。
若要新增、更新和刪除，您必須指定 [父標識符] 或 [ 資產群組 和 營銷活動 ] 字段。
加： 唯讀和必要
更新： 唯讀和必要
刪除： 唯讀和必要
行銷活動
包含資產群組和清單群組的活動名稱。
若要新增、更新和刪除，您必須指定 [父標識符] 或 [ 資產群組 和 營銷活動 ] 字段。
加： 唯讀和必要
更新： 唯讀和必要
刪除： 唯讀和必要
用戶端識別碼
用來將大量上傳檔案中的記錄與結果檔中的記錄產生關聯。 伺服器不會使用或儲存此欄位的值;它只會從上傳的記錄複製到對應的結果記錄。 它可以是長度上限為100的任何有效字串。
加： 自選
更新： 自選
刪除： 唯讀
識別碼
系統產生的資產群組清單群組標識符。
加： 自選。 您必須將此欄位保留空白，或指定負識別碼。 接著可以在相依記錄類型的 [ 父 標識符] 字段中參考資產群組清單群組的負標識符集，例如廣告、關鍵詞或準則。 如果您要在相同的大量檔案中新增新的資產群組清單群組和新的相依記錄，建議您這麼做。 如需詳細資訊，請 參閱大量檔案架構參考密鑰。
更新： 唯讀和必要
刪除： 唯讀和必要
已排除
判斷產品是否屬於清單群組，在提供服務時是否應該排除。
如果設為 true ，則為負數準則，否則為 false 則為正數準則。
加： 必填
更新： 唯讀
刪除： 唯讀
修改時間
上次更新實體的日期和時間。 值為國際標準時間 (UTC)。
注意事項
日期和時間值會反映伺服器上的日期和時間，而不是用戶端。 如需日期和時間格式的相關信息，請參閱 基本 XML 數據類型中的 dateTime 專案。
加： 唯讀
更新： 唯讀
刪除： 唯讀
父項識別碼
包含清單群組的資產群組標識碼。
若要新增、更新和刪除，您必須指定 [父標識符 ] 或 [ 資產群組 ] 和 [ 營銷活動 ] 字段。
加： 唯讀和必要
更新： 唯讀和必要
刪除： 唯讀和必要
父清單群組標識碼
您至少必須指定樹狀結構的根節點。
清單群組的根節點必須將其 [產品條件 1] 欄位設定為 [ 全部 ] 和 [產品值 1 ] 為 Null 或 空白。
如果您同樣地對目錄中的所有產品都抱抱心，請將 [子類型] 字段設定為 [單位]。
如果您要根據更特定的產品條件來分割產品，請將 [子類型] 字段設定為 [細分]、將 [父列表群組標識符] 設定為 Null 或 空白，並將 [標識符] 設定為負值。 針對任何子節點，您將使用負值作為父清單群組標識符。
加： 必填
更新： 唯讀和必要
刪除： 唯讀和必要
產品條件 1
條件的操作數。 操作數隱含包含等號運算符。 例如，您可以將 Brand 讀取為 Brand=。
每個Microsoft效能最大值資產群組都可以指定多個產品條件。 如果產品的屬性值等於操作數的屬性值，就會符合每個條件。 例如，如果操作數設定為 Brand，且 屬性設定為 Contoso，則如果產品目錄的 Brand 屬性值等於 Contoso，就會符合條件。
在 [效能上限] 活動中，產品條件只能在資產群組層級設定。 下表說明資產群組 AssetGroupListingGroup 對象的產品條件 (操作數) 和產品值 (屬性) 商務規則。
| 產品條件 (操作數) | 產品值 (屬性) 描述 | 資產群組產品分割規則 |
|---|---|---|
| 全部 | 必須是 null。 | 對於資產群組的產品分割區，根節點必須將操作數設定為 All ，並將屬性設定為Null或空白。 |
| 品牌 | 產品的製造商、品牌或發行者。 最多 1,000 個字元。 |
對於資產群組的產品分割區，根節點必須將操作數設定為 All ，並將屬性設定為Null或空白。 |
| CategoryL1-5 有五個類別操作數值可供使用，例如 CategoryL1、CategoryL2、CategoryL3、CategoryL4 和 CategoryL5。 |
Microsoft商家中心商店所定義的產品類別。 如需有效的類別值和分類法，請參閱 Bing 類別分類法。 CategoryL0 是最高層級的類別，而 CategoryL4 是最低層級或最細微的類別。 最多100個字元。 |
每個 CategoryL 操作數都可以在多個分支中使用。 每個 CategoryL 操作數都可以在多個分支中使用，但每個分支只能指定一次。 例如，一個分支可能包含 CategoryL1 和 CategoryL2，但不能包含具有 CategoryL2 操作數的另一個節點。 如果您將操作數設定為從 1 到 5 的產品類別，則必須以遞增順序指定。 例如，如果較高層級的產品分割區具有具有類別目錄的操作數 CategoryL1，則操作數可以設定為 CategoryL2，且屬性為 Pet Supplies &。 不需要在直接父數據分割中指定先前層級的產品類別操作數。 例如，如果其父系的父系指定 CategoryL1 條件，則可以為產品分割區指定 CategoryL2 條件。 |
| 通道 | 本機清查廣告 (LIA) 頻道。 可能的值包括「本地商店」和「在線」。 如果營銷活動尚未選擇加入 本機清查廣告，則所有供應項目預設只會 (Channel=Online) 和單一頻道 (ChannelExclusivity=Single-channel) 。 如需詳細資訊，請參閱 本機清查廣告 說明頁面。 |
通道操作數可用於多個分支，但每個分支只能指定一次。 |
| ChannelExclusivity | 本機清查廣告 (LIA) 頻道包容性。 可能的值包括 「Single-channel」 和 「Multi-channel」。。 如果營銷活動尚未選擇加入 本機清查廣告，則所有供應項目預設只會 (Channel=Online) 和單一頻道 (ChannelExclusivity=Single-channel) 。 如需詳細資訊，請參閱 本機清查廣告 說明頁面。 |
ChannelExclusivity 操作數可用於多個分支，但每個分支只能指定一次。 |
| 條件 | 產品的條件。 如果操作數設定為 Condition，您可以指定的支持屬性值為 New、 Used 和 已修改。 |
Condition 操作數可用於多個分支，但每個分支只能指定一次。 |
| CustomLabel0-4 有五個自定義標籤操作數值可供使用，例如 CustomLabel0、CustomLabel1、CustomLabel2、CustomLabel3 和 CustomLabel4。 |
由商家定義的自定義標籤。 自定義標籤，例如 CustomLabel0 和 CustomLabel4，不會根據任何階層進行驗證。 最多100個字元。 |
每個 CustomLabel 操作數都可以在多個分支中使用，但每個分支只能指定一次。 例如，一個分支可能包含 CustomLabel0 和 CustomLabel1，但不能包含另一個具有 CustomLabel1 操作數的節點。 |
| 識別碼 | 商家所定義的產品標識碼。 最多 1,000 個字元。 |
Id 操作數可用於多個分支，但每個分支只能指定一次。 |
| ProductType1-5 有五個產品類型操作數值可供使用，例如 ProductType1、ProductType2、ProductType3、ProductType4 和 ProductType5。 |
由商家定義的產品類型或類別。 ProductType1 是最高層級的產品類型，而 ProductType5 是最低層級或最細微的產品類型。 最多100個字元。 |
每個 ProductType 操作數都可以在多個分支中使用，但每個分支只能指定一次。 例如，一個分支可能包含 ProductType1 和 ProductType2，但不能包含另一個具有 ProductType2 操作數的節點。 如果您將操作數設定為從 1 到 5 的產品類型，則必須以遞增順序指定。 例如，如果較高層級的產品分割區具有具有屬性為 [動物 & 寵物供應器] 的操作數 ProductType1，操作數可以設定為 ProductType2 與屬性 Pet Supplies。 不需要在直接父數據分割中指定先前層級的產品類型操作數。 例如，如果 ProductType2 條件的父系指定 ProductType1 條件，則可以為產品分割區指定 ProductType2 條件。 |
加： 必填
更新： 唯讀。 您無法更新條件或值欄位。 若要更新條件，您必須刪除產品磁碟分區，並新增一個新的分割區。
刪除： 唯讀
產品值 1
條件的屬性值。
屬性的值必須完全符合客戶Microsoft商家中心目錄檔案中指定的值。
加： 必填
更新： 唯讀。 您無法更新條件或值欄位。 若要更新條件，您必須刪除產品磁碟分區，並新增一個新的分割區。
刪除： 唯讀
狀態
資產群組清單群組的狀態。
可能的值為 Active、 Deleted。
加： 自選。
更新： 自選。 如果未設定更新的值，則此設定不會變更。
刪除： 必填。 [狀態] 必須設定為 [已刪除]。
子類型
資產群組清單群組的類型。
可能的值為 [細分 ] 和 [ 單位]。
加： 必填
更新： 唯讀
刪除： 唯讀