标签记录 - 批量

项目
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 的必应广告 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
说明
Id
Label
修改时间
状态

颜色

十六进制代码的标签颜色。

十六进制值必须具有“#”前缀。例如，可以将 #FFFFFF 的值用于白标签。

可以在 Microsoft Advertising Web 应用程序中查看该颜色。应用程序可以显示颜色或利用十六进制值对一组标签进行分类。

添加： 选。如果未指定任何颜色，则会为每个标签随机分配该值。
更新： 选。如果未为更新设置任何值，则不会更改此设置。可以更新颜色代码，但不能删除它。
删除： 只读

客户端 ID

用于将批量上传文件中的记录与结果文件中的记录相关联。服务器不使用或存储此字段的值;它只是从上传的记录复制到相应的结果记录。它可以是长度最大为 100 的任何有效字符串。

添加： 选
更新： 选
删除： 只读

说明

标签说明。

标签说明的长度在 1 到 200 个字符之间。

添加： 选
更新： 选。如果未为更新设置任何值，则不会更改此设置。
删除： 只读

Id

标签的系统生成的标识符。

添加： 选。必须将此字段留空，或指定负标识符。然后，可以在相关记录类型（如市场活动标签）的“父 ID”字段中引用为标签设置的负标识符。如果要在同一批量文件中添加新标签和新的依赖记录，则建议这样做。有关详细信息，请参阅批量文件架构引用密钥。
更新： 只读和必需
删除： 只读和必需

修改时间

上次更新实体的日期和时间。该值以协调世界时 (UTC) 表示。

注意

日期和时间值反映服务器的日期和时间，而不是客户端。有关日期和时间格式的信息，请参阅基元 XML 数据类型中的 dateTime 条目。

添加： 只读
更新： 只读
删除： 只读

状态

标签的状态。

可能的值为 Active 或 Deleted。

添加： 选。默认值为 Active。
更新： 选。如果未为更新设置任何值，则不会更改此设置。
删除： 必填。 “状态”必须设置为 “已删除”。

通过

标签记录 - 批量

颜色

客户端 ID

说明

Id

标签

修改时间

状态

反馈

其他资源