Method: advertisers.negativeKeywordLists.negativeKeywords.bulkEdit

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

このオペレーションでは、BulkEditNegativeKeywordsRequest.deleted_negative_keywords で指定された除外キーワードが削除され、BulkEditNegativeKeywordsRequest.created_negative_keywords で指定された除外キーワードが作成されます。

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

HTTP リクエスト

POST https://displayvideo.googleapis.com/v1/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.BulkEdit 除外キーワードに対するレスポンス メッセージです。

JSON 表現 
{
  "negativeKeywords": [
    {
      object (NegativeKeyword)
    }
  ]
}
フィールド
negativeKeywords[]

object (NegativeKeyword)

正常に作成された除外キーワードのリスト。

空の場合、このリストは存在しません。

認可スコープ

次の OAuth スコープが必要です。

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

詳細については、OAuth 2.0 の概要をご覧ください。