Display & Video 360 API

Display & Video 360 API allows users to manage and create campaigns and reports.

Service: displayvideo.googleapis.com

We recommend that you call this service using Google-provided client libraries. If your application needs to call this service using your own libraries, you should use the following information when making the API requests.

Discovery document

A Discovery Document is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery document:

Service endpoint

A service endpoint is a base URL that specifies the network address of an API service. One service may have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:

  • https://displayvideo.googleapis.com

REST Resource: v1.advertisers

Methods
audit GET /v1/advertisers/{advertiserId}:audit
Audits an advertiser.
bulkEditAdvertiserAssignedTargetingOptions POST /v1/advertisers/{advertiserId}:bulkEditAdvertiserAssignedTargetingOptions
Bulk edits targeting options under a single advertiser.
bulkListAdvertiserAssignedTargetingOptions GET /v1/advertisers/{advertiserId}:bulkListAdvertiserAssignedTargetingOptions
Lists assigned targeting options of an advertiser across targeting types.
create POST /v1/advertisers
Creates a new advertiser.
delete DELETE /v1/advertisers/{advertiserId}
Deletes an advertiser.
get GET /v1/advertisers/{advertiserId}
Gets an advertiser.
list GET /v1/advertisers
Lists advertisers that are accessible to the current user.
patch PATCH /v1/advertisers/{advertiser.advertiserId}
Updates an existing advertiser.

REST Resource: v1.advertisers.assets

Methods
upload POST /upload/v1/advertisers/{advertiserId}/assets
Uploads an asset.

REST Resource: v1.advertisers.campaigns

Methods
create POST /v1/advertisers/{campaign.advertiserId}/campaigns
Creates a new campaign.
delete DELETE /v1/advertisers/{advertiserId}/campaigns/{campaignId}
Permanently deletes a campaign.
get GET /v1/advertisers/{advertiserId}/campaigns/{campaignId}
Gets a campaign.
list GET /v1/advertisers/{advertiserId}/campaigns
Lists campaigns in an advertiser.
patch PATCH /v1/advertisers/{campaign.advertiserId}/campaigns/{campaign.campaignId}
Updates an existing campaign.

REST Resource: v1.advertisers.channels

Methods
create POST /v1/advertisers/{advertiserId}/channels
Creates a new channel.
get GET /v1/advertisers/{advertiserId}/channels/{channelId}
Gets a channel for a partner or advertiser.
list GET /v1/advertisers/{advertiserId}/channels
Lists channels for a partner or advertiser.
patch PATCH /v1/advertisers/{advertiserId}/channels/{channel.channelId}
Updates a channel.

REST Resource: v1.advertisers.channels.sites

Methods
bulkEdit POST /v1/advertisers/{advertiserId}/channels/{channelId}/sites:bulkEdit
Bulk edits sites under a single channel.
create POST /v1/advertisers/{advertiserId}/channels/{channelId}/sites
Creates a site in a channel.
delete DELETE /v1/advertisers/{advertiserId}/channels/{channelId}/sites/{urlOrAppId}
Deletes a site from a channel.
list GET /v1/advertisers/{advertiserId}/channels/{channelId}/sites
Lists sites in a channel.

REST Resource: v1.advertisers.creatives

Methods
create POST /v1/advertisers/{creative.advertiserId}/creatives
Creates a new creative.
delete DELETE /v1/advertisers/{advertiserId}/creatives/{creativeId}
Deletes a creative.
get GET /v1/advertisers/{advertiserId}/creatives/{creativeId}
Gets a creative.
list GET /v1/advertisers/{advertiserId}/creatives
Lists creatives in an advertiser.
patch PATCH /v1/advertisers/{creative.advertiserId}/creatives/{creative.creativeId}
Updates an existing creative.

REST Resource: v1.advertisers.insertionOrders

Methods
create POST /v1/advertisers/{insertionOrder.advertiserId}/insertionOrders
Creates a new insertion order.
delete DELETE /v1/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}
Deletes an insertion order.
get GET /v1/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}
Gets an insertion order.
list GET /v1/advertisers/{advertiserId}/insertionOrders
Lists insertion orders in an advertiser.
patch PATCH /v1/advertisers/{insertionOrder.advertiserId}/insertionOrders/{insertionOrder.insertionOrderId}
Updates an existing insertion order.

REST Resource: v1.advertisers.lineItems

Methods
bulkEditLineItemAssignedTargetingOptions POST /v1/advertisers/{advertiserId}/lineItems/{lineItemId}:bulkEditLineItemAssignedTargetingOptions
Bulk edits targeting options under a single line item.
bulkListLineItemAssignedTargetingOptions GET /v1/advertisers/{advertiserId}/lineItems/{lineItemId}:bulkListLineItemAssignedTargetingOptions
Lists assigned targeting options of a line item across targeting types.
create POST /v1/advertisers/{lineItem.advertiserId}/lineItems
Creates a new line item.
delete DELETE /v1/advertisers/{advertiserId}/lineItems/{lineItemId}
Deletes a line item.
get GET /v1/advertisers/{advertiserId}/lineItems/{lineItemId}
Gets a line item.
list GET /v1/advertisers/{advertiserId}/lineItems
Lists line items in an advertiser.
patch PATCH /v1/advertisers/{lineItem.advertiserId}/lineItems/{lineItem.lineItemId}
Updates an existing line item.

REST Resource: v1.advertisers.lineItems.targetingTypes.assignedTargetingOptions

Methods
create POST /v1/advertisers/{advertiserId}/lineItems/{lineItemId}/targetingTypes/{targetingType}/assignedTargetingOptions
Assigns a targeting option to a line item.
delete DELETE /v1/advertisers/{advertiserId}/lineItems/{lineItemId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId}
Deletes an assigned targeting option from a line item.
get GET /v1/advertisers/{advertiserId}/lineItems/{lineItemId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId}
Gets a single targeting option assigned to a line item.
list GET /v1/advertisers/{advertiserId}/lineItems/{lineItemId}/targetingTypes/{targetingType}/assignedTargetingOptions
Lists the targeting options assigned to a line item.

REST Resource: v1.advertisers.locationLists

Methods
create POST /v1/advertisers/{advertiserId}/locationLists
Creates a new location list.
get GET /v1/advertisers/{advertiserId}/locationLists/{locationListId}
Gets a location list.
list GET /v1/advertisers/{advertiserId}/locationLists
Lists location lists based on a given advertiser id.
patch PATCH /v1/advertisers/{advertiserId}/locationLists/{locationList.locationListId}
Updates a location list.

REST Resource: v1.advertisers.locationLists.assignedLocations

Methods
bulkEdit POST /v1/advertisers/{advertiserId}/locationLists/{locationListId}/assignedLocations:bulkEdit
Bulk edits multiple assignments between locations and a single location list.
create POST /v1/advertisers/{advertiserId}/locationLists/{locationListId}/assignedLocations
Creates an assignment between a location and a location list.
delete DELETE /v1/advertisers/{advertiserId}/locationLists/{locationListId}/assignedLocations/{assignedLocationId}
Deletes the assignment between a location and a location list.
list GET /v1/advertisers/{advertiserId}/locationLists/{locationListId}/assignedLocations
Lists locations assigned to a location list.

REST Resource: v1.advertisers.negativeKeywordLists

Methods
create POST /v1/advertisers/{advertiserId}/negativeKeywordLists
Creates a new negative keyword list.
delete DELETE /v1/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}
Deletes a negative keyword list given an advertiser ID and a negative keyword list ID.
get GET /v1/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}
Gets a negative keyword list given an advertiser ID and a negative keyword list ID.
list GET /v1/advertisers/{advertiserId}/negativeKeywordLists
Lists negative keyword lists based on a given advertiser id.
patch PATCH /v1/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordList.negativeKeywordListId}
Updates a negative keyword list.

REST Resource: v1.advertisers.negativeKeywordLists.negativeKeywords

Methods
bulkEdit POST /v1/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}/negativeKeywords:bulkEdit
Bulk edits negative keywords in a single negative keyword list.
create POST /v1/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}/negativeKeywords
Creates a negative keyword in a negative keyword list.
delete DELETE /v1/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}/negativeKeywords/{keywordValue}
Deletes a negative keyword from a negative keyword list.
list GET /v1/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}/negativeKeywords
Lists negative keywords in a negative keyword list.

REST Resource: v1.advertisers.targetingTypes.assignedTargetingOptions

Methods
create POST /v1/advertisers/{advertiserId}/targetingTypes/{targetingType}/assignedTargetingOptions
Assigns a targeting option to an advertiser.
delete DELETE /v1/advertisers/{advertiserId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId}
Deletes an assigned targeting option from an advertiser.
get GET /v1/advertisers/{advertiserId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId}
Gets a single targeting option assigned to an advertiser.
list GET /v1/advertisers/{advertiserId}/targetingTypes/{targetingType}/assignedTargetingOptions
Lists the targeting options assigned to an advertiser.

REST Resource: v1.combinedAudiences

Methods
get GET /v1/combinedAudiences/{combinedAudienceId}
Gets a combined audience.
list GET /v1/combinedAudiences
Lists combined audiences.

REST Resource: v1.customBiddingAlgorithms

Methods
get GET /v1/customBiddingAlgorithms/{customBiddingAlgorithmId}
Gets a custom bidding algorithm.
list GET /v1/customBiddingAlgorithms
Lists custom bidding algorithms that are accessible to the current user and can be used in bidding stratgies.

REST Resource: v1.customLists

Methods
get GET /v1/customLists/{customListId}
Gets a custom list.
list GET /v1/customLists
Lists custom lists.

REST Resource: v1.firstAndThirdPartyAudiences

Methods
get GET /v1/firstAndThirdPartyAudiences/{firstAndThirdPartyAudienceId}
Gets a first and third party audience.
list GET /v1/firstAndThirdPartyAudiences
Lists first and third party audiences.

REST Resource: v1.floodlightGroups

Methods
get GET /v1/floodlightGroups/{floodlightGroupId}
Gets a Floodlight group.
patch PATCH /v1/floodlightGroups/{floodlightGroup.floodlightGroupId}
Updates an existing Floodlight group.

REST Resource: v1.googleAudiences

Methods
get GET /v1/googleAudiences/{googleAudienceId}
Gets a Google audience.
list GET /v1/googleAudiences
Lists Google audiences.

REST Resource: v1.inventorySourceGroups

Methods
create POST /v1/inventorySourceGroups
Creates a new inventory source group.
delete DELETE /v1/inventorySourceGroups/{inventorySourceGroupId}
Deletes an inventory source group.
get GET /v1/inventorySourceGroups/{inventorySourceGroupId}
Gets an inventory source group.
list GET /v1/inventorySourceGroups
Lists inventory source groups that are accessible to the current user.
patch PATCH /v1/inventorySourceGroups/{inventorySourceGroup.inventorySourceGroupId}
Updates an inventory source group.

REST Resource: v1.inventorySourceGroups.assignedInventorySources

Methods
bulkEdit POST /v1/inventorySourceGroups/{inventorySourceGroupId}/assignedInventorySources:bulkEdit
Bulk edits multiple assignments between inventory sources and a single inventory source group.
create POST /v1/inventorySourceGroups/{inventorySourceGroupId}/assignedInventorySources
Creates an assignment between an inventory source and an inventory source group.
delete DELETE /v1/inventorySourceGroups/{inventorySourceGroupId}/assignedInventorySources/{assignedInventorySourceId}
Deletes the assignment between an inventory source and an inventory source group.
list GET /v1/inventorySourceGroups/{inventorySourceGroupId}/assignedInventorySources
Lists inventory sources assigned to an inventory source group.

REST Resource: v1.inventorySources

Methods
get GET /v1/inventorySources/{inventorySourceId}
Gets an inventory source.
list GET /v1/inventorySources
Lists inventory sources that are accessible to the current user.

REST Resource: v1.media

Methods
download GET /download/{resourceName=**}
Downloads media.

REST Resource: v1.partners

Methods
bulkEditPartnerAssignedTargetingOptions POST /v1/partners/{partnerId}:bulkEditPartnerAssignedTargetingOptions
Bulk edits targeting options under a single partner.
get GET /v1/partners/{partnerId}
Gets a partner.
list GET /v1/partners
Lists partners that are accessible to the current user.

REST Resource: v1.partners.channels

Methods
create POST /v1/partners/{partnerId}/channels
Creates a new channel.
get GET /v1/partners/{partnerId}/channels/{channelId}
Gets a channel for a partner or advertiser.
list GET /v1/partners/{partnerId}/channels
Lists channels for a partner or advertiser.
patch PATCH /v1/partners/{partnerId}/channels/{channel.channelId}
Updates a channel.

REST Resource: v1.partners.channels.sites

Methods
bulkEdit POST /v1/partners/{partnerId}/channels/{channelId}/sites:bulkEdit
Bulk edits sites under a single channel.
create POST /v1/partners/{partnerId}/channels/{channelId}/sites
Creates a site in a channel.
delete DELETE /v1/partners/{partnerId}/channels/{channelId}/sites/{urlOrAppId}
Deletes a site from a channel.
list GET /v1/partners/{partnerId}/channels/{channelId}/sites
Lists sites in a channel.

REST Resource: v1.partners.targetingTypes.assignedTargetingOptions

Methods
create POST /v1/partners/{partnerId}/targetingTypes/{targetingType}/assignedTargetingOptions
Assigns a targeting option to a partner.
delete DELETE /v1/partners/{partnerId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId}
Deletes an assigned targeting option from a partner.
get GET /v1/partners/{partnerId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId}
Gets a single targeting option assigned to a partner.
list GET /v1/partners/{partnerId}/targetingTypes/{targetingType}/assignedTargetingOptions
Lists the targeting options assigned to a partner.

REST Resource: v1.sdfdownloadtasks

Methods
create POST /v1/sdfdownloadtasks
Creates an SDF Download Task.

REST Resource: v1.sdfdownloadtasks.operations

Methods
get GET /v1/{name=sdfdownloadtasks/operations/*}
Gets the latest state of an asynchronous SDF download task operation.

REST Resource: v1.targetingTypes.targetingOptions

Methods
get GET /v1/targetingTypes/{targetingType}/targetingOptions/{targetingOptionId}
Gets a single targeting option.
list GET /v1/targetingTypes/{targetingType}/targetingOptions
Lists targeting options of a given type.

REST Resource: v1.users

Methods
bulkEditAssignedUserRoles POST /v1/users/{userId}:bulkEditAssignedUserRoles
Bulk edits user roles for a user.
create POST /v1/users
Creates a new user.
delete DELETE /v1/users/{userId}
Deletes a user.
get GET /v1/users/{userId}
Gets a user.
list GET /v1/users
Lists users that are accessible to the current user.
patch PATCH /v1/users/{user.userId}
Updates an existing user.