Method: advertisers.negativeKeywordLists.negativeKeywords.bulkEdit

1 つの除外キーワード リスト内の除外キーワードを一括編集します。

この操作により、BulkEditNegativeKeywordsRequest.deleted_negative_keywords で指定された除外キーワードが削除され、BulkEditNegativeKeywordsRequest.created_negative_keywords で指定された除外キーワードが作成されます。

このオペレーションはアトミックであることが保証されており、部分的な成功や部分的な失敗にはなりません。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
advertiserId

string (int64 format)

必須。親除外キーワード リストが属するディスプレイ&ビデオ 360 広告主の 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 の概要をご覧ください。