Method: advertisers.locationLists.assignedLocations.bulkEdit

  • Display & Video 360 API v2 has been sunset and is no longer supported.

  • This documentation details the bulk editing process for assigned locations within location lists in Display & Video 360.

  • Users can delete and create multiple location assignments using the provided bulkEdit endpoint and specifying the necessary IDs.

  • The request body requires specifying deletedAssignedLocations and createdAssignedLocations for the operation.

  • Successful responses will include a list of newly created assignedLocations, if any.

Bulk edits multiple assignments between locations and a single location list.

The operation will delete the assigned locations provided in deletedAssignedLocations and then create the assigned locations provided in createdAssignedLocations.

HTTP request

POST https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/locationLists/{locationListId}/assignedLocations:bulkEdit

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
advertiserId

string (int64 format)

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

string (int64 format)

Required. The ID of the location list to which these assignments are assigned.

Request body

The request body contains data with the following structure:

JSON representation 
{
  "deletedAssignedLocations": [
    string
  ],
  "createdAssignedLocations": [
    {
      object (AssignedLocation)
    }
  ]
}
Fields
deletedAssignedLocations[]

string (int64 format)

The IDs of the assigned locations to delete in bulk, specified as a list of assignedLocationId values.
createdAssignedLocations[]

object (AssignedLocation)

The assigned locations to create in bulk, specified as a list of AssignedLocation resources.

Response body

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

JSON representation 
{
  "assignedLocations": [
    {
      object (AssignedLocation)
    }
  ]
}
Fields
assignedLocations[]

object (AssignedLocation)

The list of assigned locations 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.