通过

广告组标签记录 - 批量

  • 项目

定义可在批量文件中上传和下载 的“广告组 ”和 “标签 ”之间的关联记录。 若要上传或下载广告组或标签，请使用 广告组 或 标签 记录。

通过在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 服务请求中包含 AdGroupLabels 的 DownloadEntity 值，可以下载帐户中的所有广告组标签记录。 此外，下载请求必须包括 EntityData 范围。 有关批量服务的更多详细信息（包括最佳做法），请参阅 批量下载和上传。

如果提供了有效的 ID 和父ID 值，以下批量 CSV 示例会将标签应用于广告组。

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

如果使用用于 .NET、Java 或 Python 的必应广告 SDK ，则可以使用 BulkServiceManager 来节省时间来上传和下载 BulkAdGroupLabel 对象，而无需直接调用服务操作和编写自定义代码来分析批量文件中的每个字段。

var uploadEntities = new List<BulkEntity>();

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

    // Map properties in the Bulk file to the 
    // LabelAssociation object of the Campaign Management service.
    LabelAssociation = new LabelAssociation
    {
        // 'Parent Id' column header in the Bulk file
        EntityId = adGroupIdKey,
        // 'Id' column header in the Bulk file
        LabelId = labelIdKey
    },

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

uploadEntities.Add(bulkAdGroupLabel);

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

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

对于 广告组标签 记录， 批量文件架构中提供了以下属性字段。

注意

下载文件中不返回“广告组”和“市场活动”字段。

广告组

应用或删除此标签的广告组的名称。

添加： 只读
删除： 只读

注意

若要添加和删除，必须指定 “父 ID ”或 “广告组 ”和“ 市场活动 ”字段。

Campaign

包含应用或删除此标签的广告组的市场活动的名称。

添加： 只读
删除： 只读

注意

若要添加和删除，必须指定 “父 ID ”或 “广告组 ”和“ 市场活动 ”字段。 对于批量下载，不返回 “广告组 ”和 “市场活动” 字段。

客户端 ID

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

添加： 选
删除： 只读

Id

从广告组应用或删除的标签的标识符。

此批量字段映射到“标签”记录的“ID”字段。

添加： 只读和必需。 必须指定现有标签标识符，或指定等于父标签记录的 ID 字段的负标识符。 如果要将新标签应用于同一批量文件中的广告组，则建议这样做。 有关详细信息，请参阅 批量文件架构引用密钥。
删除： 只读和必需

修改时间

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

注意

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

添加： 只读
删除： 只读

父 ID

应用或删除此标签的广告组的标识符。

此批量字段映射到广告组记录的 Id 字段。

添加： 只读和必需。 必须指定现有广告组标识符，或指定等于父广告组记录的 Id 字段的负标识符。 如果将标签应用于同一批量文件中的新广告组，则建议这样做。 有关详细信息，请参阅 批量文件架构引用密钥。
删除： 只读和必需

注意

若要添加和删除，必须指定 “父 ID ”或 “广告组 ”和“ 市场活动 ”字段。 对于批量下载，不返回 “广告组 ”和 “市场活动” 字段。

状态

表示广告组与标签之间的应用状态。

可能的值为 Active 和 Deleted。 如果标签应用于广告组，则此字段的值为 Active。

添加： 只读
删除： 必填。 “状态”必须设置为 “已删除”。