Method: advertisers.negativeKeywordLists.negativeKeywords.bulkEdit

在一个否定关键字列表中批量修改否定关键字。

此操作将删除 BulkEditNegativeKeywordsRequest.deleted_negative_keywords 中提供的否定关键字,然后创建 BulkEditNegativeKeywordsRequest.created_negative_keywords 中提供的否定关键字。

此操作保证是原子操作,绝不会导致部分成功或部分失败。

HTTP 请求

POST https://displayvideo.googleapis.com/v1/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}/negativeKeywords:bulkEdit

网址采用 gRPC 转码语法。

路径参数

参数
advertiserId

string (int64 format)

必需。父级否定关键字列表所属的 DV360 广告客户的 ID。

negativeKeywordListId

string (int64 format)

必需。否定关键字所属的父级否定关键字列表的 ID。

请求正文

请求正文中包含结构如下的数据:

JSON 表示法
{
  "deletedNegativeKeywords": [
    string
  ],
  "createdNegativeKeywords": [
    {
      object (NegativeKeyword)
    }
  ]
}
字段
deletedNegativeKeywords[]

string

批量删除的否定关键字,以 keyword_values 列表的形式指定。

createdNegativeKeywords[]

object (NegativeKeyword)

要批量创建的否定关键字,以 NegativeKeywords 列表的形式指定。

响应正文

如果成功,响应正文将包含结构如下的数据:

NegativeKeywordService.BulkEditNegativeKeyword 的响应消息。

JSON 表示法
{
  "negativeKeywords": [
    {
      object (NegativeKeyword)
    }
  ]
}
字段
negativeKeywords[]

object (NegativeKeyword)

已成功创建的否定关键字的列表。

如果为空,则不会显示此列表。

授权范围

需要以下 OAuth 作用域:

  • https://www.googleapis.com/auth/display-video

有关详情,请参阅 OAuth 2.0 概览