通过

展开的文本广告标签记录 - 批量

  • 项目

定义 扩展文本广告 和标签之间的关联 记录，该 记录可以在批量文件中上传和下载。 若要上传或下载展开的文本广告或标签，请使用 展开的文本广告 或 标签 记录。

注意

  • 在 2023 年 2 月 1 日之前，将展开的文本广告升级到响应式搜索广告。 在此日期之后，你将无法再创建新的或编辑现有的扩展文本广告。 有关详细信息，请参阅 关于响应式搜索广告。
  • 现有的扩展文本广告将继续投放，你将能够查看其性能报告。
  • 你仍然可以暂停、启用或删除展开的文本广告。 否则，尝试添加或更新展开的文本广告将导致 CampaignServiceAdTypeInvalid 错误。
  • 详细了解此更改。

通过在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 服务请求中包含 ExpandedTextAdLabels 的 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,,,
Expanded Text Ad Label,,-22,-11112,,,ClientIdGoesHere,,,,,

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkExpandedTextAdLabel
var bulkExpandedTextAdLabel = new BulkExpandedTextAdLabel
{
    // '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 = expandedTextAdIdKey,
        // 'Id' column header in the Bulk file
        LabelId = labelIdKey
    },

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

uploadEntities.Add(bulkExpandedTextAdLabel);

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

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

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

客户端 ID

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

添加： 选
删除： 只读

Id

从展开的文本广告中应用或删除的标签的标识符。

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

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

修改时间

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

注意

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

添加： 只读
删除： 只读

父 ID

应用或删除此标签的展开文本广告的标识符。

此批量字段映射到展开的文本广告记录的 Id 字段。

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

状态

表示展开的文本广告与标签之间的应用状态。

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

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