Frequently Asked Questions
Stay organized with collections
Save and categorize content based on your preferences.
General
What's the latest version of the API?
The latest version of the API that this document addresses is v1beta2.
This version is a private beta release available to trusted testers.
Who can access the API?
v1beta2 access is only available to allow listed Google APIs console projects. Access to API documentation is controlled by a separate user allow list.
How can I tell if my console project has been allow listed?
Select an API key from your project by clicking on the API_KEY element in the URL below. If an API key doesn't exist for the selected project, you'll be prompted to create one. When done, copy and paste the resulting URL into your browser.
https://displayvideo.googleapis.com/$discovery/rest?version=v1beta2&labels=V1BETA2_TRUSTED_TESTER&key=API_KEY
If you see a JSON description of the API, your project has been allow listed. If you see an error, then you project has not been allow listed.
Using the API
What URL do I use to access the API?
https://displayvideo.googleapis.com
What methods of authentication are supported?
OAuth 2.0 is the only supported method of authentication. All requests must be authorized for the following scope:
https://www.googleapis.com/auth/display-video
I want to write code. Where can I find client libraries?
Python
The publicly available Google API Client Library for Python can be used to access this API. To install the library and create an authorized service object, follow the steps below.
Install the google-api-python-client
pip install --upgrade google-api-python-client
Obtain an authorized credentials object. See the Set Up Your Application guide for an example.
Create an authorized service object using the discovery service.
api_key = 'API_KEY'
api_name = 'displayvideo'
api_url = 'https://%s.googleapis.com/' % api_name
api_version = 'v1beta2'
discovery_url = (
'%s/$discovery/rest?key=%s&version=%s&labels=%s'
% (api_url, api_key, api_version, 'V1BETA2_TRUSTED_TESTER')
)
service = discovery.build(api_name, api_version,
discoveryServiceUrl=discovery_url,
http=credentials)
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-28 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[[["\u003cp\u003eThis API is currently in private beta (\u003ccode\u003ev1beta2\u003c/code\u003e) and accessible only to allow-listed Google API Console projects.\u003c/p\u003e\n"],["\u003cp\u003eAuthentication is exclusively through OAuth 2.0 with the \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eThe API can be accessed at \u003ccode\u003ehttps://displayvideo.googleapis.com\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eA Python client library is available, requiring installation and authorization setup as detailed in the documentation.\u003c/p\u003e\n"],["\u003cp\u003eYou can check your project's allow-list status by attempting to access the API's JSON description with your API key.\u003c/p\u003e\n"]]],[],null,["# Frequently Asked Questions\n\nGeneral\n-------\n\n### What's the latest version of the API?\n\nThe latest version of the API that this document addresses is `v1beta2`.\nThis version is a private beta release available to trusted testers.\n\n### Who can access the API?\n\n`v1beta2` access is only available to allow listed Google APIs console projects. Access to API documentation is controlled by a separate user allow list.\n\n### How can I tell if my console project has been allow listed?\n\nSelect an API key from your project by clicking on the `API_KEY` element in the URL below. If an API key doesn't exist for the selected project, you'll be prompted to create one. When done, copy and paste the resulting URL into your browser. \n\n```scdoc\nhttps://displayvideo.googleapis.com/$discovery/rest?version=v1beta2&labels=V1BETA2_TRUSTED_TESTER&key=API_KEY\n```\n\nIf you see a JSON description of the API, your project has been allow listed. If you see an error, then you project has not been allow listed.\n\nUsing the API\n-------------\n\n### What URL do I use to access the API?\n\n`https://displayvideo.googleapis.com`\n\n### What methods of authentication are supported?\n\nOAuth 2.0 is the only supported method of authentication. All requests must be authorized for the following scope:\n\n- `https://www.googleapis.com/auth/display-video`\n\n### I want to write code. Where can I find client libraries?\n\n### Python\n\nThe publicly available [Google API Client Library for Python](https://github.com/google/google-api-python-client) can be used to access this API. To install the library and create an authorized service object, follow the steps below.\n\n1. Install the google-api-python-client\n\n ```\n pip install --upgrade google-api-python-client\n ```\n2. Obtain an authorized `credentials` object. See the [Set Up Your Application guide](/display-video/api/guides/getting-started/configure) for an example.\n\n3. Create an authorized service object using the discovery service.\n\n ```python\n api_key = 'API_KEY'\n api_name = 'displayvideo'\n api_url = 'https://%s.googleapis.com/' % api_name\n api_version = 'v1beta2'\n\n discovery_url = (\n '%s/$discovery/rest?key=%s&version=%s&labels=%s'\n % (api_url, api_key, api_version, 'V1BETA2_TRUSTED_TESTER')\n )\n\n service = discovery.build(api_name, api_version,\n discoveryServiceUrl=discovery_url,\n http=credentials)\n ```"]]
