Method: advertisers.locationLists.assignedLocations.bulkEdit

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

  • This operation allows for bulk editing of multiple assignments between locations and a single location list by deleting specified assigned locations and then creating new ones.

  • The HTTP request uses a POST method with a specific URL structure including advertiserId and locationListId as path parameters.

  • The request body contains lists for assigned locations to be deleted and assigned locations to be created.

  • The response body, if successful, contains a list of assigned locations that were successfully created.

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

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/v3/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.