標籤記錄 - 大量

發行項
11/13/2024

定義可在大量檔案中上傳和下載的標籤。

標籤可讓您根據任何對您很重要的專案，將行銷活動、廣告群組、廣告和關鍵字組織成群組。然後，您可以篩選並執行標籤上的報表，以取得對您最有意義的資料。

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

下列大量 CSV 範例會新增標籤。

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Name,Description,Label,Color
Format Version,,,,,,,,6.0,,,
Label,,-22,,,,ClientIdGoesHere,,,Label Description,Label Name,#FFFFFF

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkLabel
var bulkLabel = new BulkLabel
{
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // Label object of the Campaign Management service.
    Label = new Label
    {
        // 'Color' column header in the Bulk file
        ColorCode = "#FFFFFF",
        // 'Description' column header in the Bulk file
        Description = "Label Description",
        // 'Id' column header in the Bulk file
        Id = labelIdKey,
        // 'Label' column header in the Bulk file
        Name = "Label Name " + DateTime.UtcNow
    },

    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkLabel);

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

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

針對標籤記錄，大量檔案架構中提供下列屬性欄位。

Color
用戶端識別碼
描述
Id
Label
修改時間
狀態

色彩

作為十六進位程式碼的標籤色彩。

十六進位值必須有 '#' 前置詞。例如，您可以將 #FFFFFF 的值用於白色標籤。

您可以在 Microsoft Advertising Web 應用程式中檢視色彩。您的應用程式可以顯示色彩，或利用十六進位值來分類一組標籤。

添加： 選。如果您未指定任何色彩，則會針對每個標籤隨機指派值。
更新： 選。如果未設定更新的值，則此設定不會變更。您可以更新色彩代碼，但無法移除它。
刪除： 唯讀

用戶端識別碼

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

添加： 選
更新： 選
刪除： 唯讀

說明

標籤描述。

標籤描述的長度可以介於 1 到 200 個字元之間。

添加： 選
更新： 選。如果未設定更新的值，則此設定不會變更。
刪除： 唯讀

識別碼

系統產生的標籤識別碼。

添加： 選。您必須將此欄位保留空白，或指定負識別碼。接著，您可以在啟動磁碟區標等相依記錄類型的 [父識別碼] 欄位中參考卷標的負識別碼集。如果您要在相同的大量檔案中新增新的標籤和新的相依記錄，建議您這麼做。如需詳細資訊，請參閱大量檔案架構參考金鑰。
更新： 唯讀和必要
刪除： 唯讀和必要

修改時間

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

注意事項

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

添加： 唯讀
更新： 唯讀
刪除： 唯讀

狀態

標籤的狀態。

可能的值為 [作用中 ] 或 [已刪除]。

添加： 選。預設值為 Active。
更新： 選。如果未設定更新的值，則此設定不會變更。
刪除： 必填。 [狀態] 必須設定為 [ 已刪除]。

共用方式為

標籤記錄 - 大量

色彩

用戶端識別碼

說明

識別碼

標籤

修改時間

狀態

意見反應

其他資源