Method: advertisers.negativeKeywordLists.negativeKeywords.bulkEdit

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

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

這項作業保證可完整執行,而且絕對不會導致部分成功或部分失敗。

HTTP 要求

POST https://displayvideo.googleapis.com/v2/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 清單。

回應主體

排除 KeywordService.BulkEditExclude keywords 的回應訊息。

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

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

object (NegativeKeyword)

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

如果留空,這份清單就不會顯示。

授權範圍

需要下列 OAuth 範圍:

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

詳情請參閱 OAuth 2.0 總覽