Google Display & Video 360 Advertisers API
The advertiser-scoped slice of the Display & Video 360 API — 103 operations under /v4/advertisers covering campaigns, insertion orders, line items, ad groups, ad group ads, creatives, ad assets, channels and sites, location lists, negative keyword lists, invoices, reach forecasting and assigned targeting options.
Operations 107
POST
/v4/advertisers/{advertisersId}:editAssignedTargetingOptions
Edits targeting options under a single advertiser.
#
GET
/v4/advertisers/{advertisersId}:listAssignedTargetingOptions
Lists assigned targeting options of an advertiser across targeting types.
#
POST
/v4/advertisers/{advertisersId}/adGroups:bulkEditAssignedTargetingOptions
Bulk edits targeting options for multiple ad groups.
#
GET
/v4/advertisers/{advertisersId}/adGroups:bulkListAssignedTargetingOptions
Lists assigned targeting options for multiple ad groups across targeting types.
#
POST
/v4/advertisers/{advertisersId}/adGroups/{adGroupsId}/targetingTypes/{targetingTypesId}/assignedTargetingOptions
Assigns a targeting option to an ad group.
#
GET
/v4/advertisers/{advertisersId}/adGroups/{adGroupsId}/targetingTypes/{targetingTypesId}/assignedTargetingOptions
Lists the targeting options assigned to an ad group.
#
GET
/v4/advertisers/{advertisersId}/adGroups/{adGroupsId}/targetingTypes/{targetingTypesId}/assignedTargetingOptions/{assignedTargetingOptionsId}
Gets a single targeting option assigned to an ad group.
#
DELETE
/v4/advertisers/{advertisersId}/adGroups/{adGroupsId}/targetingTypes/{targetingTypesId}/assignedTargetingOptions/{assignedTargetingOptionsId}
Deletes an assigned targeting option from an ad group.
#
GET
/v4/advertisers/{advertisersId}/adGroups/{adGroupsId}/youtubeAssetTypes/{youtubeAssetTypesId}/youtubeAssetAssociations
Lists the YouTube asset associations linked to the given resource.
#
POST
/v4/advertisers/{advertisersId}/adGroups/{adGroupsId}/youtubeAssetTypes/{youtubeAssetTypesId}/youtubeAssetAssociations
Creates a new association between the identified resource and a YouTube asset.
#
DELETE
/v4/advertisers/{advertisersId}/adGroups/{adGroupsId}/youtubeAssetTypes/{youtubeAssetTypesId}/youtubeAssetAssociations/{youtubeAssetAssociationsId}
Deletes an existing association between the identified resource and a YouTube asset.
#
GET
/v4/advertisers/{advertisersId}/lineItems:bulkListAssignedTargetingOptions
Lists assigned targeting options for multiple line items across targeting types.
#
POST
/v4/advertisers/{advertisersId}/lineItems:bulkEditAssignedTargetingOptions
Bulk edits targeting options under multiple line items.
#
POST
/v4/advertisers/{advertisersId}/lineItems/{lineItemsId}/targetingTypes/{targetingTypesId}/assignedTargetingOptions
Assigns a targeting option to a line item.
#
GET
/v4/advertisers/{advertisersId}/lineItems/{lineItemsId}/targetingTypes/{targetingTypesId}/assignedTargetingOptions
Lists the targeting options assigned to a line item.
#
GET
/v4/advertisers/{advertisersId}/lineItems/{lineItemsId}/targetingTypes/{targetingTypesId}/assignedTargetingOptions/{assignedTargetingOptionsId}
Gets a single targeting option assigned to a line item.
#
DELETE
/v4/advertisers/{advertisersId}/lineItems/{lineItemsId}/targetingTypes/{targetingTypesId}/assignedTargetingOptions/{assignedTargetingOptionsId}
Deletes an assigned targeting option from a line item.
#
POST
/v4/advertisers/{advertisersId}/lineItems/{lineItemsId}/youtubeAssetTypes/{youtubeAssetTypesId}/youtubeAssetAssociations
Creates a new association between the identified resource and a YouTube asset.
#
GET
/v4/advertisers/{advertisersId}/lineItems/{lineItemsId}/youtubeAssetTypes/{youtubeAssetTypesId}/youtubeAssetAssociations
Lists the YouTube asset associations linked to the given resource.
#
DELETE
/v4/advertisers/{advertisersId}/lineItems/{lineItemsId}/youtubeAssetTypes/{youtubeAssetTypesId}/youtubeAssetAssociations/{youtubeAssetAssociationsId}
Deletes an existing association between the identified resource and a YouTube asset.
#
GET
/v4/advertisers/{advertisersId}/channels/{channelsId}
Gets a channel for a partner or advertiser.
#
POST
/v4/advertisers/{advertiserId}/channels/{channelsId}/sites:replace
Replaces all of the sites under a single channel.
#
DELETE
/v4/advertisers/{advertiserId}/channels/{channelsId}/sites/{sitesId}
Deletes a site from a channel.
#
POST
/v4/advertisers/{advertiserId}/channels/{channelsId}/sites:bulkEdit
Bulk edits sites under a single channel.
#
PATCH
/v4/advertisers/{advertisersId}/insertionOrders/{insertionOrdersId}
Updates an existing insertion order.
#
DELETE
/v4/advertisers/{advertisersId}/insertionOrders/{insertionOrdersId}
Deletes an insertion order.
#
GET
/v4/advertisers/{advertisersId}/reachForecast:retrievePlannableUserLists
Retrieves first and third party user lists available for forecasting.
#
POST
/v4/advertisers/{advertisersId}/reachForecast:generateReachForecast
Generates a reach forecast for a given advertiser and targeting configuration.
#
GET
/v4/advertisers/{advertisersId}/reachForecast:retrievePlannableLocations
Retrieves the list of countries where reach forecasting is supported.
#
GET
/v4/advertisers/{advertisersId}/reachForecast:retrievePlannableProducts
Retrieves the list of products that can be planned for a location.
#
GET
/v4/advertisers/{advertisersId}/reachForecast:retrievePlannableUserInterests
Retrieves Google Audiences (User Interests) available for forecasting.
#
GET
/v4/advertisers/{advertisersId}/locationLists
Lists location lists based on a given advertiser id.
#
POST
/v4/advertisers/{advertiserId}/locationLists/{locationListId}/assignedLocations
Creates an assignment between a location and a location list.
#
GET
/v4/advertisers/{advertiserId}/locationLists/{locationListId}/assignedLocations
Lists locations assigned to a location list.
#
DELETE
/v4/advertisers/{advertiserId}/locationLists/{locationListId}/assignedLocations/{assignedLocationsId}
Deletes the assignment between a location and a location list.
#
POST
/v4/advertisers/{advertiserId}/locationLists/{locationListsId}/assignedLocations:bulkEdit
Bulk edits multiple assignments between locations and a single location list.
#
GET
/v4/advertisers/{advertisersId}/targetingTypes/{targetingTypesId}/assignedTargetingOptions/{assignedTargetingOptionsId}
Gets a single targeting option assigned to an advertiser.
#
DELETE
/v4/advertisers/{advertisersId}/targetingTypes/{targetingTypesId}/assignedTargetingOptions/{assignedTargetingOptionsId}
Deletes an assigned targeting option from an advertiser.
#
GET
/v4/advertisers/{advertisersId}/targetingTypes/{targetingTypesId}/assignedTargetingOptions
Lists the targeting options assigned to an advertiser.
#
POST
/v4/advertisers/{advertisersId}/targetingTypes/{targetingTypesId}/assignedTargetingOptions
Assigns a targeting option to an advertiser.
#
POST
/v4/advertisers/{advertisersId}/adAssets:bulkCreate
Creates multiple ad assets in a single request.
#
GET
/v4/advertisers/{advertisersId}/invoices
Lists invoices posted for an advertiser in a given month.
#
GET
/v4/advertisers/{advertisersId}/invoices:lookupInvoiceCurrency
Retrieves the invoice currency used by an advertiser in a given month.
#
GET
/v4/advertisers/{advertisersId}/negativeKeywordLists
Lists negative keyword lists based on a given advertiser id.
#
PATCH
/v4/advertisers/{advertisersId}/negativeKeywordLists/{negativeKeywordListId}
Updates a negative keyword list.
#
GET
/v4/advertisers/{advertisersId}/negativeKeywordLists/{negativeKeywordListsId}
Gets a negative keyword list given an advertiser ID and a negative keyword list ID.
#
DELETE
/v4/advertisers/{advertisersId}/negativeKeywordLists/{negativeKeywordListsId}
Deletes a negative keyword list given an advertiser ID and a negative keyword list ID.
#
POST
/v4/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListsId}/negativeKeywords
Creates a negative keyword in a negative keyword list.
#
POST
/v4/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListsId}/negativeKeywords:replace
Replaces all negative keywords in a single negative keyword list.
#
DELETE
/v4/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListsId}/negativeKeywords/{negativeKeywordsId}
Deletes a negative keyword from a negative keyword list.
#
POST
/v4/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListsId}/negativeKeywords:bulkEdit
Bulk edits negative keywords in a single negative keyword list.
#
GET
/v4/advertisers/{advertisersId}/negativeKeywordLists/{negativeKeywordListsId}/negativeKeywords
Lists negative keywords in a negative keyword list.
#
GET
/v4/advertisers/{advertiserId}/insertionOrders
Google Display & Video 360 List insertion orders
#
Documentation
📖
Documentation
https://developers.google.com/display-video/api/reference/rest
📖
Authentication
https://developers.google.com/display-video/api/guides/how-tos/authorizing
📖
GettingStarted
https://developers.google.com/display-video/api/guides/getting-started/overview
Specifications
Schemas & Data
Other Resources
🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/google-display-video-360/refs/heads/main/overlays/google-display-video-360-advertisers-api-overlay.yaml
🔗
JSONLD
https://raw.githubusercontent.com/api-evangelist/google-display-video-360/refs/heads/main/json-ld/json-ld.yml
🔗
GraphQL
https://raw.githubusercontent.com/api-evangelist/google-display-video-360/refs/heads/main/graphql/google-display-video-360-graphql.md
🔗
APIsJSON
https://raw.githubusercontent.com/api-evangelist/google-display-video-360/refs/heads/main/apis.yml