Google Display & Video 360

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.

GitHub OpenAPI

Operations 107

GET /v4/advertisers/{advertisersId} Gets an advertiser #
DELETE /v4/advertisers/{advertisersId} Deletes an advertiser #
PATCH /v4/advertisers/{advertisersId} Updates an existing advertiser #
GET /v4/advertisers/{advertisersId}:audit Audits an advertiser #
POST /v4/advertisers Creates a new advertiser #
GET /v4/advertisers Lists advertisers that are accessible to the current user #
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}/assets Uploads an asset #
POST /v4/advertisers/{advertisersId}/adGroups Creates a new ad group #
GET /v4/advertisers/{advertisersId}/adGroups Lists ad groups #
POST /v4/advertisers/{advertisersId}/adGroups:bulkEditAssignedTargetingOptions Bulk edits targeting options for multiple ad groups #
GET /v4/advertisers/{advertisersId}/adGroups/{adGroupsId} Gets an ad group #
DELETE /v4/advertisers/{advertisersId}/adGroups/{adGroupsId} Deletes a AdGroup #
PATCH /v4/advertisers/{advertisersId}/adGroups/{adGroupsId} Updates an existing ad group #
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… #
POST /v4/advertisers/{advertisersId}/lineItems Creates a new line item #
GET /v4/advertisers/{advertisersId}/lineItems Lists line items in an advertiser #
GET /v4/advertisers/{advertisersId}/lineItems:bulkListAssignedTargetingOptions Lists assigned targeting options for multiple line items across targeting types #
PATCH /v4/advertisers/{advertisersId}/lineItems/{lineItemsId} Updates an existing line item #
GET /v4/advertisers/{advertisersId}/lineItems/{lineItemsId} Gets a line item #
DELETE /v4/advertisers/{advertisersId}/lineItems/{lineItemsId} Deletes a line item #
POST /v4/advertisers/{advertisersId}/lineItems/{lineItemsId}:duplicate Duplicates a line item #
POST /v4/advertisers/{advertisersId}/lineItems:bulkUpdate Updates multiple line items #
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… #
PATCH /v4/advertisers/{advertisersId}/channels/{channelId} Updates a channel #
GET /v4/advertisers/{advertisersId}/channels/{channelsId} Gets a channel for a partner or advertiser #
GET /v4/advertisers/{advertisersId}/channels Lists channels for a partner or advertiser #
POST /v4/advertisers/{advertisersId}/channels Creates a new channel #
GET /v4/advertisers/{advertisersId}/channels/{channelsId}/sites Lists sites in a channel #
POST /v4/advertisers/{advertiserId}/channels/{channelsId}/sites Creates a site in a channel #
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 #
POST /v4/advertisers/{advertisersId}/creatives Creates a new creative #
GET /v4/advertisers/{advertisersId}/creatives Lists creatives in an advertiser #
GET /v4/advertisers/{advertisersId}/creatives/{creativesId} Gets a creative #
DELETE /v4/advertisers/{advertisersId}/creatives/{creativesId} Deletes a creative #
PATCH /v4/advertisers/{advertisersId}/creatives/{creativesId} Updates an existing creative #
POST /v4/advertisers/{advertisersId}/adGroupAds Creates an ad group ad #
GET /v4/advertisers/{advertisersId}/adGroupAds Lists ad group ads #
GET /v4/advertisers/{advertisersId}/adGroupAds/{adGroupAdsId} Gets an ad group ad #
DELETE /v4/advertisers/{advertisersId}/adGroupAds/{adGroupAdsId} Deletes an ad group ad #
PATCH /v4/advertisers/{advertisersId}/adGroupAds/{adGroupAdsId} Updates an ad group ad #
PATCH /v4/advertisers/{advertisersId}/insertionOrders/{insertionOrdersId} Updates an existing insertion order #
GET /v4/advertisers/{advertisersId}/insertionOrders/{insertionOrdersId} Gets an insertion order #
DELETE /v4/advertisers/{advertisersId}/insertionOrders/{insertionOrdersId} Deletes an insertion order #
GET /v4/advertisers/{advertisersId}/insertionOrders Lists insertion orders in an advertiser #
POST /v4/advertisers/{advertisersId}/insertionOrders Creates a new 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 #
POST /v4/advertisers/{advertisersId}/campaigns Creates a new campaign #
GET /v4/advertisers/{advertisersId}/campaigns Lists campaigns in an advertiser #
GET /v4/advertisers/{advertisersId}/campaigns/{campaignsId} Gets a campaign #
DELETE /v4/advertisers/{advertisersId}/campaigns/{campaignsId} Permanently deletes a campaign #
PATCH /v4/advertisers/{advertisersId}/campaigns/{campaignsId} Updates an existing campaign #
GET /v4/advertisers/{advertisersId}/locationLists/{locationListsId} Gets a location list #
GET /v4/advertisers/{advertisersId}/locationLists Lists location lists based on a given advertiser id #
POST /v4/advertisers/{advertisersId}/locationLists Creates a new location list #
PATCH /v4/advertisers/{advertisersId}/locationLists/{locationListId} Updates a location list #
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 Creates an ad asset #
GET /v4/advertisers/{advertisersId}/adAssets Lists ad assets under an advertiser ID #
GET /v4/advertisers/{advertisersId}/adAssets/{adAssetsId} Gets an ad asset #
PATCH /v4/advertisers/{advertisersId}/adAssets/{adAssetsId} Updates an ad asset #
POST /v4/advertisers/{advertisersId}/adAssets:uploadAdAsset Uploads and creates an ad asset #
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 #
POST /v4/advertisers/{advertisersId}/negativeKeywordLists Creates a new negative keyword list #
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… #
DELETE /v4/advertisers/{advertisersId}/negativeKeywordLists/{negativeKeywordListsId} Deletes a negative keyword list given an advertiser ID and a negative keyword… #
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}/campaigns Google Display & Video 360 List campaigns #
GET /v4/advertisers/{advertiserId}/insertionOrders Google Display & Video 360 List insertion orders #
GET /v4/advertisers/{advertiserId}/lineItems Google Display & Video 360 List line items #
GET /v4/advertisers/{advertiserId}/creatives Google Display & Video 360 List creatives #

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

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/google-display-video-360/refs/heads/main/openapi/google-display-video-360-advertisers-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/google-display-video-360/refs/heads/main/json-schema/json-schema.yml

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
🔗
APIsJSON
https://raw.githubusercontent.com/api-evangelist/google-display-video-360/refs/heads/main/apis.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/google-display-video-360-advertisers-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

google-display-video-360-advertisers-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Google Display Video 360 Advertisers API
  version: v4
  license:
    name: Google APIs Terms of Service
    url: https://developers.google.com/terms
  x-refined-note:
  - x-google-discovery-document differs across the merged source definitions and was not carried
  - x-google-discovery-revision differs across the merged source definitions and was not carried
  description: 'Operations tagged Advertisers across 2 of this provider''s published API definitions: google-display-video-360-api-openapi.yml, openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://displayvideo.googleapis.com
  description: Display & Video 360 API server
security:
- oauth2:
  - https://www.googleapis.com/auth/display-video
tags:


# --- truncated at 32 KB (758 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/google-display-video-360/refs/heads/main/openapi/google-display-video-360-advertisers-api-openapi.yml