通过

共享负关键字记录 - 批量

  • 项目

定义一个负关键字 (keyword) ，该负关键字 (keyword) 列表中共享，并且可以在批量文件中下载和上传。

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

以下批量 CSV 示例将在给定父 ID) 的有效负关键字 (keyword) 列表 ID (负关键字 (keyword) 列表中添加新的负关键字 (keyword) 。

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Keyword,Match Type,Name
Format Version,,,,,,,,,,6.0
Shared Negative Keyword,Active,,-19,,,ClientIdGoesHere,,shoes,Exact,

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

var uploadEntities = new List<BulkEntity>();

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

    // Map properties in the Bulk file to the 
    // NegativeKeyword object of the Campaign Management service.
    NegativeKeyword = new NegativeKeyword
    {
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Match Type' column header in the Bulk file
        MatchType = MatchType.Exact,
        // 'Text' column header in the Bulk file
        Text = "shoes"
    },

    // 'Parent Id' column header in the Bulk file
    NegativeKeywordListId = negativeKeywordListIdKey,

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

uploadEntities.Add(bulkSharedNegativeKeyword);

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

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

对于 共享负关键字 记录， 批量文件架构中提供了以下属性字段。

客户端 ID

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

添加： 选
更新： 不适用。 可以添加和删除负关键字 (keyword) ，但不能更新。
删除： 只读

Id

负关键字 (keyword) 的系统生成的标识符。

添加： 只读
更新： 不适用。 可以添加和删除负关键字 (keyword) ，但不能更新。
删除： 只读和必需

关键字

负关键字 (keyword) 文本。

文本最多可以包含 100 个字符。

添加： 必填
更新： 不适用。 可以添加和删除负关键字 (keyword) ，但不能更新。
删除： 只读

匹配类型

要比较负关键字 (keyword) 和用户的搜索词的匹配类型。

负关键字 (keyword) 支持的匹配类型值为 Phrase 和 Exact。

添加： 必填
更新： 不适用。 可以添加和删除负关键字 (keyword) ，但不能更新。
删除： 只读

修改时间

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

注意

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

添加： 只读
更新： 不适用。 可以添加和删除负关键字 (keyword) ，但不能更新。
删除： 只读

父 ID

包含负关键字 (keyword) 的负关键字 (keyword) 列表的系统生成的标识符。

此批量字段映射到“负关键字列表”记录的“ID”字段。

添加： 只读和必需。 必须指定现有的负关键字 (keyword) 列表标识符，或指定等于父负关键字列表记录的 Id 字段的负标识符。 如果要将新的否定关键字添加到同一批量文件中的新负关键字 (keyword) 列表，则建议这样做。 有关详细信息，请参阅 批量文件架构引用密钥。
更新： 不适用。 可以添加和删除负关键字 (keyword) ，但不能更新。
删除： 只读

状态

表示负关键字 (keyword) 列表与负关键字 (keyword) 之间的关联状态。

如果负关键字 (keyword) 与负关键字 (keyword) 列表相关联，则此字段的值为“活动”。

可能的值为 Active 或 Deleted。

添加： 选。 默认值为 Active。
更新： 不适用。 可以添加和删除负关键字 (keyword) ，但不能更新。
删除： 必填。 “状态”必须设置为 “已删除”。