Method: advertisers.negativeKeywordLists.negativeKeywords.bulkEdit

  • The bulkEdit method allows for simultaneously deleting and creating negative keywords within a single negative keyword list.

  • This operation is atomic, meaning it either fully succeeds or completely fails, ensuring no partial updates.

  • The request uses a POST HTTP method with path parameters for the advertiser and negative keyword list IDs.

  • The request body specifies keywords to be deleted by their values and keywords to be created as NegativeKeyword objects.

  • The response body contains a list of the negative keywords that were successfully created.

  • Authorization requires the https://www.googleapis.com/auth/display-video OAuth scope.

Bulk edits negative keywords in a single negative keyword list.

The operation will delete the negative keywords provided in BulkEditNegativeKeywordsRequest.deleted_negative_keywords and then create the negative keywords provided in BulkEditNegativeKeywordsRequest.created_negative_keywords.

This operation is guaranteed to be atomic and will never result in a partial success or partial failure.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
advertiserId

string (int64 format)

Required. The ID of the DV360 advertiser to which the parent negative keyword list belongs.
negativeKeywordListId

string (int64 format)

Required. The ID of the parent negative keyword list to which the negative keywords belong.

Request body

The request body contains data with the following structure:

JSON representation 
{
  "deletedNegativeKeywords": [
    string
  ],
  "createdNegativeKeywords": [
    {
      object (NegativeKeyword)
    }
  ]
}
Fields
deletedNegativeKeywords[]

string

The negative keywords to delete in batch, specified as a list of keyword_values.
createdNegativeKeywords[]

object (NegativeKeyword)

The negative keywords to create in batch, specified as a list of NegativeKeywords.

Response body

If successful, the response body contains data with the following structure:

Response message for NegativeKeywordService.BulkEditNegativeKeywords.

JSON representation 
{
  "negativeKeywords": [
    {
      object (NegativeKeyword)
    }
  ]
}
Fields
negativeKeywords[]

object (NegativeKeyword)

The list of negative keywords that have been successfully created.

This list will be absent if empty.

Authorization Scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.