Method: advertisers.negativeKeywordLists.negativeKeywords.bulkEdit

在單一排除關鍵字清單中大量編輯排除關鍵字。

這項作業會刪除 BulkEditNegativeKeywordsRequest.deleted_negative_keywords 中提供的排除關鍵字，然後建立 BulkEditNegativeKeywordsRequest.created_negative_keywords 中提供的排除關鍵字。

這項作業保證為不可分割，絕不會導致部分成功或部分失敗。

HTTP 要求

POST https://displayvideo.googleapis.com/v3/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.BulkEditNegativeKeywords 的回應訊息。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "negativeKeywords": [
    {
      object (NegativeKeyword)
    }
  ]
}
欄位
negativeKeywords[]

object (NegativeKeyword)

已成功建立的排除關鍵字清單。

如果清單為空白，則不會顯示這項資訊。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。