共用方式為

帳戶映射廣告延伸模組記錄 - 大量

  • 發行項

定義 帳戶 與 影像廣告延伸 模組之間的關聯記錄，可在大量檔案中上傳和下載。 若要上傳或下載帳戶或影像廣告延伸模組，請使用 帳戶 或 Image Ad Extension 記錄。

您可以在DownloadCampaignsByAccountIds或DownloadCampaignsByCampaignIds服務要求中包含AccountImageAdExtensions的DownloadEntity值，以下載帳戶中的所有帳戶影像廣告延伸模組記錄。 此外，下載要求必須包含 EntityData 範圍。 如需大量服務的詳細資訊，包括最佳做法，請參閱 大量下載和上傳。

如果 提供有效的標識 符，下列大量 CSV 範例會將影像廣告延伸模組與帳戶產生關聯。

Type,Status,Id,Parent Id,Client Id,Modified Time,Name
Format Version,,,,,,6.0
Account Image Ad Extension,Active,-11,,ClientIdGoesHere,,

如果您使用適用于 .NET、JAVA 或 Python 的 Bing Ads SDK ，您可以使用 BulkServiceManager 來節省時間來上傳和下載 BulkAccountImageAdExtension 物件，而不是直接呼叫服務作業，並撰寫自訂程式碼來剖析大量檔案中的每個欄位。

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkAccountImageAdExtension
var bulkAccountImageAdExtension = new BulkAccountImageAdExtension
{
    // 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 = imageAdExtensionIdKey,
        // 'Parent Id' column header in the Bulk file
        EntityId = accountIdKey,
    },
                
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
    // 'Status' column header in the Bulk file
    Status = Status.Active,
};

uploadEntities.Add(bulkAccountImageAdExtension);

var entityUploadParameters = new EntityUploadParameters
{
    Entities = uploadEntities,
    ResponseMode = ResponseMode.ErrorsAndResults,
    ResultFileDirectory = FileDirectory,
    ResultFileName = DownloadFileName,
    OverwriteResultFile = true,
};

var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();

針對 帳戶映射廣告延伸 模組記錄， 大量檔案架構中提供下列屬性欄位。

用戶端識別碼

用來將大量上傳檔案中的記錄與結果檔中的記錄產生關聯。 伺服器不會使用或儲存此欄位的值;它只會從上傳的記錄複製到對應的結果記錄。 它可以是長度上限為 100 的任何有效字串。

添加： 選
刪除： 唯讀

編輯位置

編輯檢閱失敗的廣告延伸模組元件或屬性。

添加： 唯讀
刪除： 唯讀

編輯原因代碼

識別失敗原因的程式碼。 如需可能的原因代碼清單，請參閱 編輯原因代碼。

添加： 唯讀
刪除： 唯讀

編輯狀態

廣告延伸模組的編輯狀態。

下表說明可能的值。

值 描述
作用中 廣告延伸模組已通過編輯檢閱。
ActiveLimited 廣告延伸模組已在一或多個市場中通過編輯檢閱，而廣告延伸模組的一或多個元素正在另一個市場中進行編輯檢閱。 例如，廣告延伸模組已通過加拿大的編輯檢閱，且仍在美國中擱置檢閱。
反對 廣告延伸模組的編輯檢閱失敗。
非作用中 廣告延伸模組的一或多個元素正在進行編輯檢閱。

添加： 唯讀
刪除： 唯讀

編輯詞彙

失敗的編輯檢閱詞彙。

如果字片語合造成失敗，或失敗是以原則違規為基礎，則不會設定此欄位。

添加： 唯讀
刪除： 唯讀

識別碼

與帳戶相關聯或移除之廣告延伸模組的識別碼。

這個大量欄位會對應至Image Ad Extension記錄的 [標識符] 欄位。

添加： 唯讀和必要。 您必須指定現有的廣告延伸模組識別碼，或指定等於父代Image Ad Extension記錄之 [標識符] 欄位的負識別碼。 如果您要在相同的大量檔案中新增新的廣告擴充功能和關聯，建議您這麼做。 如需詳細資訊，請 參閱大量檔案架構參考金鑰。
刪除： 唯讀和必要

修改時間

上次更新實體的日期和時間。 值為國際標準時間 (UTC)。

注意事項

日期和時間值會反映伺服器上的日期和時間，而不是用戶端。 如需日期和時間格式的相關資訊，請參閱 基本 XML 資料類型中的 dateTime 專案。

添加： 唯讀
刪除： 唯讀

父項識別碼

與此廣告延伸模組相關聯或移除之帳戶的識別碼。

此大量欄位會對應至客戶紀錄的 [ 標識 符 ] 字 段。

添加： 唯讀
刪除： 唯讀

發行者國家/地區

發行者國家或地區的清單，其編輯指導方針不允許指定的 詞彙。

在大量檔案中，發行者國家或地區的清單會以分號分隔 (;) 。

添加： 唯讀
刪除： 唯讀

狀態

表示帳戶與廣告延伸模組之間的關聯狀態。

可能的值為 Active 和 Deleted。 如果廣告延伸模組與帳戶相關聯，則此欄位的值為 Active。

添加： 唯讀
刪除： 必填。 [狀態] 必須設定為 [ 已刪除]。