Method: advertisers.bulkEditAdvertiserAssignedTargetingOptions

  • This API allows for bulk editing of targeting options under a single advertiser, enabling deletion and creation of assigned targeting options.

  • The request body includes separate lists for delete requests and create requests, each specifying the targeting options to remove or add.

  • Supported targeting types include Channel, Digital Content Label Exclusion, OMID, and Sensitive Category Exclusion for both deletion and creation.

  • A successful response returns a list of the newly created assigned targeting options, if any.

  • The operation requires authorization with the https://www.googleapis.com/auth/display-video scope.

Bulk edits targeting options under a single advertiser. The operation will delete the assigned targeting options provided in BulkEditAdvertiserAssignedTargetingOptionsRequest.delete_requests and then create the assigned targeting options provided in BulkEditAdvertiserAssignedTargetingOptionsRequest.create_requests .

HTTP request

POST https://displayvideo.googleapis.com/v1beta2/advertisers/{advertiserId}:bulkEditAdvertiserAssignedTargetingOptions

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
advertiserId

string (int64 format)

Required. The ID of the advertiser.

Request body

The request body contains data with the following structure:

JSON representation 
{
  "deleteRequests": [
    {
      object (DeleteAssignedTargetingOptionsRequest)
    }
  ],
  "createRequests": [
    {
      object (CreateAssignedTargetingOptionsRequest)
    }
  ]
}
Fields
deleteRequests[]

object (DeleteAssignedTargetingOptionsRequest)

The assigned targeting options to delete in batch, specified as a list of DeleteAssignedTargetingOptionsRequest.

Supported targeting types:
createRequests[]

object (CreateAssignedTargetingOptionsRequest)

The assigned targeting options to create in batch, specified as a list of CreateAssignedTargetingOptionsRequest.

Supported targeting types:

Response body

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

JSON representation 
{
  "createdAssignedTargetingOptions": [
    {
      object (AssignedTargetingOption)
    }
  ]
}
Fields
createdAssignedTargetingOptions[]

object (AssignedTargetingOption)

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