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 清單的形式指定。

回應主體

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

負面關鍵字服務.大量編輯排除關鍵字的回應訊息。

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

object (NegativeKeyword)

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

如果留空，這份清單將不會顯示。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。