Method: advertisers.negativeKeywordLists.patch

  • Display & Video 360 API v3 has sunset, and users should use v4 instead.

  • This document describes how to update a negative keyword list using the DV360 API v3, including the HTTP request, parameters, request/response bodies, and required authorization scopes.

  • The update operation requires specifying the advertiser ID, the negative keyword list ID, and an update mask to indicate which fields to modify.

Updates a negative keyword list. Returns the updated negative keyword list if successful.

HTTP request

PATCH https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordList.negativeKeywordListId}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
advertiserId

string (int64 format)

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

negativeKeywordList.negativeKeywordListId

string (int64 format)

Output only. The unique ID of the negative keyword list. Assigned by the system.

Query parameters

Parameters
updateMask

string (FieldMask format)

Required. The mask to control which fields to update.

This is a comma-separated list of fully qualified names of fields. Example: "user.displayName,photo".

Request body

The request body contains an instance of NegativeKeywordList.

Response body

If successful, the response body contains an instance of NegativeKeywordList.

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.