Method: inventorySourceGroups.assignedInventorySources.bulkEdit

  • Display & Video 360 API v3 is sunset and users should transition to v4.

  • This page details the bulkEdit method for inventorySourceGroups.assignedInventorySources in the DV360 API v3.

  • The bulkEdit operation allows for the simultaneous deletion and creation of multiple assignments between inventory sources and a single inventory source group.

  • The request requires specifying the inventory source group ID and the assigned inventory sources to be deleted or created, along with the owning partner or advertiser ID.

  • A successful response will return a list of the successfully created assigned inventory sources.

Bulk edits multiple assignments between inventory sources and a single inventory source group.

The operation will delete the assigned inventory sources provided in BulkEditAssignedInventorySourcesRequest.deleted_assigned_inventory_sources and then create the assigned inventory sources provided in BulkEditAssignedInventorySourcesRequest.created_assigned_inventory_sources.

HTTP request

POST https://displayvideo.googleapis.com/v3/inventorySourceGroups/{inventorySourceGroupId}/assignedInventorySources:bulkEdit

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
inventorySourceGroupId

string (int64 format)

Required. The ID of the inventory source group to which the assignments are assigned.

Request body

The request body contains data with the following structure:

JSON representation 
{
  "deletedAssignedInventorySources": [
    string
  ],
  "createdAssignedInventorySources": [
    {
      object (AssignedInventorySource)
    }
  ],

  // Union field owner can be only one of the following:
  "partnerId": string,
  "advertiserId": string
  // End of list of possible types for union field owner.
}
Fields
deletedAssignedInventorySources[]

string (int64 format)

The IDs of the assigned inventory sources to delete in bulk, specified as a list of assigned_inventory_source_ids.
createdAssignedInventorySources[]

object (AssignedInventorySource)

The assigned inventory sources to create in bulk, specified as a list of AssignedInventorySources.
Union field owner. Required. Identifies the DV360 entity that owns the parent inventory source group. It can be either a partner or an advertiser. owner can be only one of the following:
partnerId

string (int64 format)

The ID of the partner that owns the inventory source group.

Only this partner has write access to these assigned inventory sources.
advertiserId

string (int64 format)

The ID of the advertiser that owns the parent inventory source group.

The parent partner does not have access to these assigned inventory sources.

Response body

Response message for AssignedInventorySourceService.BulkEdit.

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

JSON representation 
{
  "assignedInventorySources": [
    {
      object (AssignedInventorySource)
    }
  ]
}
Fields
assignedInventorySources[]

object (AssignedInventorySource)

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