Display & Video 360 API

Display & Video 360 API allows users to automate complex Display & Video 360 workflows, such as creating insertion orders and setting targeting options for individual line items.

Service: displayvideo.googleapis.com

To call this service, we recommend that you use the Google-provided client libraries. If your application needs to use your own libraries to call this service, use the following information when you make 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 might 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: v2.advertisers

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

REST Resource: v2.advertisers.assets

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

REST Resource: v2.advertisers.campaigns

Methods
create POST /v2/advertisers/{campaign.advertiserId}/campaigns
Creates a new campaign.
delete DELETE /v2/advertisers/{advertiserId}/campaigns/{campaignId}
Permanently deletes a campaign.
get GET /v2/advertisers/{advertiserId}/campaigns/{campaignId}
Gets a campaign.
list GET /v2/advertisers/{advertiserId}/campaigns
Lists campaigns in an advertiser.
listAssignedTargetingOptions GET /v2/advertisers/{advertiserId}/campaigns/{campaignId}:listAssignedTargetingOptions
Lists assigned targeting options of a campaign across targeting types.
patch PATCH /v2/advertisers/{campaign.advertiserId}/campaigns/{campaign.campaignId}
Updates an existing campaign.

REST Resource: v2.advertisers.campaigns.targetingTypes.assignedTargetingOptions

Methods
get GET /v2/advertisers/{advertiserId}/campaigns/{campaignId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId}
Gets a single targeting option assigned to a campaign.
list GET /v2/advertisers/{advertiserId}/campaigns/{campaignId}/targetingTypes/{targetingType}/assignedTargetingOptions
Lists the targeting options assigned to a campaign for a specified targeting type.

REST Resource: v2.advertisers.channels

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

REST Resource: v2.advertisers.channels.sites

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

REST Resource: v2.advertisers.creatives

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

REST Resource: v2.advertisers.insertionOrders

Methods
create POST /v2/advertisers/{insertionOrder.advertiserId}/insertionOrders
Creates a new insertion order.
delete DELETE /v2/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}
Deletes an insertion order.
get GET /v2/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}
Gets an insertion order.
list GET /v2/advertisers/{advertiserId}/insertionOrders
Lists insertion orders in an advertiser.
listAssignedTargetingOptions GET /v2/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}:listAssignedTargetingOptions
Lists assigned targeting options of an insertion order across targeting types.
patch PATCH /v2/advertisers/{insertionOrder.advertiserId}/insertionOrders/{insertionOrder.insertionOrderId}
Updates an existing insertion order.

REST Resource: v2.advertisers.insertionOrders.targetingTypes.assignedTargetingOptions

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

REST Resource: v2.advertisers.invoices

Methods
list GET /v2/advertisers/{advertiserId}/invoices
Lists invoices posted for an advertiser in a given month.
lookupInvoiceCurrency GET /v2/advertisers/{advertiserId}/invoices:lookupInvoiceCurrency
Retrieves the invoice currency used by an advertiser in a given month.

REST Resource: v2.advertisers.lineItems

Methods
bulkEditAssignedTargetingOptions POST /v2/advertisers/{advertiserId}/lineItems:bulkEditAssignedTargetingOptions
Bulk edits targeting options under multiple line items.
bulkListAssignedTargetingOptions GET /v2/advertisers/{advertiserId}/lineItems:bulkListAssignedTargetingOptions
Lists assigned targeting options for multiple line items across targeting types.
bulkUpdate POST /v2/advertisers/{advertiserId}/lineItems:bulkUpdate
Updates multiple line items.
create POST /v2/advertisers/{lineItem.advertiserId}/lineItems
Creates a new line item.
delete DELETE /v2/advertisers/{advertiserId}/lineItems/{lineItemId}
Deletes a line item.
duplicate POST /v2/advertisers/{advertiserId}/lineItems/{lineItemId}:duplicate
Duplicates a line item.
generateDefault POST /v2/advertisers/{advertiserId}/lineItems:generateDefault
Creates a new line item with settings (including targeting) inherited from the insertion order and an ENTITY_STATUS_DRAFT entity_status.
get GET /v2/advertisers/{advertiserId}/lineItems/{lineItemId}
Gets a line item.
list GET /v2/advertisers/{advertiserId}/lineItems
Lists line items in an advertiser.
patch PATCH /v2/advertisers/{lineItem.advertiserId}/lineItems/{lineItem.lineItemId}
Updates an existing line item.

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

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

REST Resource: v2.advertisers.locationLists

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

REST Resource: v2.advertisers.locationLists.assignedLocations

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

REST Resource: v2.advertisers.manualTriggers

Methods
activate POST /v2/advertisers/{advertiserId}/manualTriggers/{triggerId}:activate
Activates a manual trigger.
create POST /v2/advertisers/{manualTrigger.advertiserId}/manualTriggers
Creates a new manual trigger.
deactivate POST /v2/advertisers/{advertiserId}/manualTriggers/{triggerId}:deactivate
Deactivates a manual trigger.
get GET /v2/advertisers/{advertiserId}/manualTriggers/{triggerId}
Gets a manual trigger.
list GET /v2/advertisers/{advertiserId}/manualTriggers
Lists manual triggers that are accessible to the current user for a given advertiser ID.
patch PATCH /v2/advertisers/{manualTrigger.advertiserId}/manualTriggers/{manualTrigger.triggerId}
Updates a manual trigger.

REST Resource: v2.advertisers.negativeKeywordLists

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

REST Resource: v2.advertisers.negativeKeywordLists.negativeKeywords

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

REST Resource: v2.advertisers.targetingTypes.assignedTargetingOptions

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

REST Resource: v2.advertisers.youtubeAdGroupAds

Methods
get GET /v2/advertisers/{advertiserId}/youtubeAdGroupAds/{youtubeAdGroupAdId}
Gets a YouTube ad group ad.
list GET /v2/advertisers/{advertiserId}/youtubeAdGroupAds
Lists YouTube ad group ads.

REST Resource: v2.advertisers.youtubeAdGroups

Methods
bulkListAdGroupAssignedTargetingOptions GET /v2/advertisers/{advertiserId}/youtubeAdGroups:bulkListAdGroupAssignedTargetingOptions
Lists assigned targeting options for multiple YouTube ad groups across targeting types.
get GET /v2/advertisers/{advertiserId}/youtubeAdGroups/{youtubeAdGroupId}
Gets a YouTube ad group.
list GET /v2/advertisers/{advertiserId}/youtubeAdGroups
Lists YouTube ad groups.

REST Resource: v2.advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions

Methods
get GET /v2/advertisers/{advertiserId}/youtubeAdGroups/{youtubeAdGroupId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId}
Gets a single targeting option assigned to a YouTube ad group.
list GET /v2/advertisers/{advertiserId}/youtubeAdGroups/{youtubeAdGroupId}/targetingTypes/{targetingType}/assignedTargetingOptions
Lists the targeting options assigned to a YouTube ad group.

REST Resource: v2.combinedAudiences

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

REST Resource: v2.customBiddingAlgorithms

Methods
create POST /v2/customBiddingAlgorithms
Creates a new custom bidding algorithm.
get GET /v2/customBiddingAlgorithms/{customBiddingAlgorithmId}
Gets a custom bidding algorithm.
list GET /v2/customBiddingAlgorithms
Lists custom bidding algorithms that are accessible to the current user and can be used in bidding stratgies.
patch PATCH /v2/customBiddingAlgorithms/{customBiddingAlgorithm.customBiddingAlgorithmId}
Updates an existing custom bidding algorithm.
uploadScript GET /v2/customBiddingAlgorithms/{customBiddingAlgorithmId}:uploadScript
Creates a custom bidding script reference object for a script file.

REST Resource: v2.customBiddingAlgorithms.scripts

Methods
create POST /v2/customBiddingAlgorithms/{customBiddingAlgorithmId}/scripts
Creates a new custom bidding script.
get GET /v2/customBiddingAlgorithms/{customBiddingAlgorithmId}/scripts/{customBiddingScriptId}
Gets a custom bidding script.
list GET /v2/customBiddingAlgorithms/{customBiddingAlgorithmId}/scripts
Lists custom bidding scripts that belong to the given algorithm.

REST Resource: v2.customLists

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

REST Resource: v2.firstAndThirdPartyAudiences

Methods
create POST /v2/firstAndThirdPartyAudiences
Creates a FirstAndThirdPartyAudience.
editCustomerMatchMembers POST /v2/firstAndThirdPartyAudiences/{firstAndThirdPartyAudienceId}:editCustomerMatchMembers
Updates the member list of a Customer Match audience.
get GET /v2/firstAndThirdPartyAudiences/{firstAndThirdPartyAudienceId}
Gets a first and third party audience.
list GET /v2/firstAndThirdPartyAudiences
Lists first and third party audiences.
patch PATCH /v2/firstAndThirdPartyAudiences/{firstAndThirdPartyAudience.firstAndThirdPartyAudienceId}
Updates an existing FirstAndThirdPartyAudience.

REST Resource: v2.floodlightGroups

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

REST Resource: v2.floodlightGroups.floodlightActivities

Methods
get GET /v2/floodlightGroups/{floodlightGroupId}/floodlightActivities/{floodlightActivityId}
Gets a Floodlight activity.
list GET /v2/floodlightGroups/{floodlightGroupId}/floodlightActivities
Lists Floodlight activities in a Floodlight group.

REST Resource: v2.googleAudiences

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

REST Resource: v2.guaranteedOrders

Methods
create POST /v2/guaranteedOrders
Creates a new guaranteed order.
editGuaranteedOrderReadAccessors POST /v2/guaranteedOrders/{guaranteedOrderId}:editGuaranteedOrderReadAccessors
Edits read advertisers of a guaranteed order.
get GET /v2/guaranteedOrders/{guaranteedOrderId}
Gets a guaranteed order.
list GET /v2/guaranteedOrders
Lists guaranteed orders that are accessible to the current user.
patch PATCH /v2/guaranteedOrders/{guaranteedOrder.guaranteedOrderId}
Updates an existing guaranteed order.

REST Resource: v2.inventorySourceGroups

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

REST Resource: v2.inventorySourceGroups.assignedInventorySources

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

REST Resource: v2.inventorySources

Methods
create POST /v2/inventorySources
Creates a new inventory source.
editInventorySourceReadWriteAccessors POST /v2/inventorySources/{inventorySourceId}:editInventorySourceReadWriteAccessors
Edits read/write accessors of an inventory source.
get GET /v2/inventorySources/{inventorySourceId}
Gets an inventory source.
list GET /v2/inventorySources
Lists inventory sources that are accessible to the current user.
patch PATCH /v2/inventorySources/{inventorySource.inventorySourceId}
Updates an existing inventory source.

REST Resource: v2.media

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

REST Resource: v2.partners

Methods
editAssignedTargetingOptions POST /v2/partners/{partnerId}:editAssignedTargetingOptions
Edits targeting options under a single partner.
get GET /v2/partners/{partnerId}
Gets a partner.
list GET /v2/partners
Lists partners that are accessible to the current user.

REST Resource: v2.partners.channels

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

REST Resource: v2.partners.channels.sites

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

REST Resource: v2.partners.targetingTypes.assignedTargetingOptions

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

REST Resource: v2.sdfdownloadtasks

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

REST Resource: v2.sdfdownloadtasks.operations

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

REST Resource: v2.targetingTypes.targetingOptions

Methods
get GET /v2/targetingTypes/{targetingType}/targetingOptions/{targetingOptionId}
Gets a single targeting option.
list GET /v2/targetingTypes/{targetingType}/targetingOptions
Lists targeting options of a given type.
search POST /v2/targetingTypes/{targetingType}/targetingOptions:search
Searches for targeting options of a given type based on the given search terms.

REST Resource: v2.users

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