Method: advertisers.locationLists.patch

  • This documentation details how to update a location list using the Display & Video 360 API.

  • It involves sending a PATCH request to a specific endpoint, providing the advertiser ID and location list ID.

  • You'll need to use an update mask to specify the fields you want to change and include the updated location list in the request body.

  • Upon successful execution, the API will respond with the updated location list.

  • This action requires authorization with the 'https://www.googleapis.com/auth/display-video' scope.

Updates a location list. Returns the updated location list if successful.

HTTP request

PATCH https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/locationLists/{locationList.locationListId}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
advertiserId

string (int64 format)

Required. The ID of the DV360 advertiser to which the location lists belongs.
locationList.locationListId

string (int64 format)

Output only. The unique ID of the location 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 LocationList.

Response body

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

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.