廣告群組標誌廣告延伸模組記錄 - 大量
定義可在大量檔案中上傳和下載的 廣告群組 與 標誌廣告延伸 模組之間的關聯記錄。 若要上傳或下載廣告群組或標誌廣告延伸模組，請使用 廣告群組 或 標誌廣告延伸 模組記錄。
您可以在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 服務要求中包含 AdGroupLogoAdExtensions 的 DownloadEntity 值，以下載帳戶中的所有 Ad Group Logo Ad Extension 記錄。 此外，下載要求必須包含 EntityData 範圍。 如需大量服務的詳細資訊，包括最佳做法，請參閱 大量下載和上傳。
如果 提供有效的標識 碼和 父 標識符值，下列大量 CSV 範例會將標誌廣告延伸模組與廣告群組產生關聯。
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Name
Format Version,,,,,,,,6.0
Ad Group Logo Ad Extension,Active,-11,-1111,,,ClientIdGoesHere,,
如果您使用適用於 .NET、Java 或 Python 的 Bing Ads SDK ，您可以使用 BulkServiceManager 來節省時間來上傳和下載 BulkAdGroupLogoAdExtension 物件，而不是直接呼叫服務作業，並撰寫自定義程式代碼來剖析大量檔案中的每個字段。
var uploadEntities = new List<BulkEntity>();
// Map properties in the Bulk file to the BulkAdGroupLogoAdExtension
var bulkAdGroupLogoAdExtension = new BulkAdGroupLogoAdExtension
{
// Map properties in the Bulk file to the
// AdExtensionIdToEntityIdAssociation object of the Campaign Management service.
AdExtensionIdToEntityIdAssociation = new AdExtensionIdToEntityIdAssociation
{
// 'Id' column header in the Bulk file
AdExtensionId = logoAdExtensionIdKey,
// 'Parent Id' column header in the Bulk file
EntityId = adGroupIdKey,
},
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// 'Status' column header in the Bulk file
Status = Status.Active,
};
uploadEntities.Add(bulkAdGroupLogoAdExtension);
var entityUploadParameters = new EntityUploadParameters
{
Entities = uploadEntities,
ResponseMode = ResponseMode.ErrorsAndResults,
ResultFileDirectory = FileDirectory,
ResultFileName = DownloadFileName,
OverwriteResultFile = true,
};
var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();
針對 廣告群組標誌廣告延伸 模組記錄， 大量檔案架構中提供下列屬性欄位。
廣告群組
與此廣告延伸模組相關聯或移除的廣告組名。
加： 唯讀和必要
刪除： 唯讀和必要
行銷活動
活動名稱，其中包含與此廣告延伸模組相關聯或移除的廣告群組。
加： 唯讀
刪除： 唯讀
用戶端識別碼
用來將大量上傳檔案中的記錄與結果檔中的記錄產生關聯。 伺服器不會使用或儲存此欄位的值;它只會從上傳的記錄複製到對應的結果記錄。 它可以是長度上限為100的任何有效字串。
加： 自選
刪除： 唯讀
編輯位置
編輯檢閱失敗的廣告延伸模組元件或屬性。
加： 唯讀
刪除： 唯讀
編輯原因代碼
識別失敗原因的程序代碼。 如需可能的原因代碼清單，請參閱 編輯原因代碼。
加： 唯讀
刪除： 唯讀
編輯狀態
廣告延伸模組的編輯狀態。
下表說明可能的值。
| 值 | 描述 |
|---|---|
| 作用中 | 廣告延伸模組已通過編輯檢閱。 |
| ActiveLimited | 廣告延伸模組已在一或多個市場中通過編輯檢閱，而廣告延伸模組的一或多個元素正在另一個市場中進行編輯檢閱。 例如，廣告延伸模組已通過加拿大的編輯檢閱，而且在美國仍擱置檢閱。 |
| 反對 | 廣告延伸模組的編輯檢閱失敗。 |
| 非作用中 | 廣告延伸模組的一或多個元素正在進行編輯檢閱。 |
加： 唯讀
刪除： 唯讀
編輯詞彙
失敗的編輯檢閱詞彙。
如果字詞組合造成失敗，或失敗是以原則違規為基礎，則不會設定此字段。
加： 唯讀
刪除： 唯讀
識別碼
與廣告群組相關聯或移除之廣告延伸模組的標識符。
這個大量欄位會對應至 Logo Ad Extension 記錄的 [標識符] 字段。
加： 唯讀和必要。 您必須指定現有的廣告延伸模組標識符，或指定等於父代Logo Ad Extension 記錄之 [標識符] 字段的負標識碼。 如果您要在相同的大量檔案中新增新的廣告擴充功能和關聯，建議您這麼做。 如需詳細資訊，請 參閱大量檔案架構參考密鑰。
刪除： 唯讀和必要
修改時間
上次更新實體的日期和時間。 值為國際標準時間 (UTC)。
注意事項
日期和時間值會反映伺服器上的日期和時間，而不是用戶端。 如需日期和時間格式的相關信息，請參閱 基本 XML 數據類型中的 dateTime 專案。
加： 唯讀
刪除： 唯讀
父項識別碼
與此廣告延伸模組相關聯或移除之廣告群組的標識碼。
此大量欄位會對應至廣告群組記錄的 [標識符] 欄位。
加： 唯讀和必要。 您必須指定現有的廣告群組標識符，或指定等於父代 Ad Group 記錄之 [標識符] 字段的負標識符。 如果您要將廣告擴充功能與相同大量檔案中的新廣告群組產生關聯，則建議您這麼做。 如需詳細資訊，請 參閱大量檔案架構參考密鑰。
刪除： 唯讀和必要
發行者國家/地區
發行者國家或地區的清單，其編輯指導方針不允許指定的 詞彙。
在大量檔案中，發行者國家或地區的清單會以分號分隔 (;) 。
加： 唯讀
刪除： 唯讀
狀態
表示帳戶與廣告延伸模組之間的關聯狀態。
可能的值為 Active 和 Deleted。 如果廣告延伸模組與廣告群組相關聯，則此字段的值為 Active。
加： 唯讀
刪除： 必填。 [狀態] 必須設定為 [ 已刪除]。