Get started

The Display & Video 360 API is the programmatic interface for the Display & Video 360 platform. You can use the Display & Video 360 API to automate complex Display & Video 360 workflows. Here are some examples of tasks you can do with the Display & Video 360 API:

• Upload and build creatives.
• Manage line items and their targeting.
• Generate and download Structured Data Files.

This guide describes how to get started with the Display & Video 360 API.

Prerequisites

Before using the Display & Video 360 API, you must do the following:

1. You must have a Google Account. You need a Google Account in order to create a project in the Google API Console. If you already have an account, then you're all set. You may also want a separate Google Account for testing purposes.

2. You must have access to Display & Video 360. You need access to the Display & Video 360 product in order to work with the API. If your organization already has a Display & Video 360 contract, ensure a user profile with appropriate permissions has been created for your Google Account(s). If not, contact our sales team for more information.

3. You should try out Display & Video 360. This API documentation assumes that you've used Display & Video 360, and that you're familiar with web programming concepts and web data formats. If you haven't used Display & Video 360, then try out the web UI before starting to code.

Choose a project

You need to create or select a project in the Google API Console and enable the API.

You can create a new project, or use an existing one.

Create a new project

Follow the steps in the Google API Console to create a project and enable the Display & Video 360 API automatically.

Use an existing project

Here's how to manually activate the Display & Video 360 API for an existing project.

To enable an API for your project, do the following:

1. Open the API Library in the Google API Console. If prompted, select a project or create a new one. The API Library lists all available APIs, grouped by product family and popularity.
2. If the API you want to enable isn't visible in the list, use search to find it.
3. Select the API you want to enable, then click the Enable button.
4. If prompted, enable billing.
5. If prompted, accept the API's Terms of Service.

Generate credentials

All requests you make to the Display & Video 360 API must be authorized. For a brief overview of authorization, read about how to authorize and identify your application to Google.

The following instructions guide you through the process of creating an OAuth 2.0 client ID to use with the installed application flow. For instructions on generating credentials for use with the service account flow, refer to the Service Accounts guide.

1. Follow the steps to configure a Google API Console project.

2. Open the Credentials page in the API Console.

3. Click Create credentials > OAuth client ID.

4. Select the most applicable application type when prompted. The Java and Python code snippets offered in these guides assume a Desktop app, while the PHP code snippets assume a Web application.

5. Enter any additional required information.

   • If this is your first time creating a client ID, besides being able to select your application type, you can configure your consent screen by clicking the Configure consent screen button. You won't get a prompt to configure your consent screen again after you do it the first time, although this information can be updated at any time.

6. Click Create.

When done, you'll be presented with an OAuth 2.0 client ID and client secret, which you can download in JSON format and save for later use.

Configure the user consent screen

When you use OAuth 2.0 for authentication, your users are authenticated after they agree to terms presented to them on a user consent screen.

To set up your project's consent screen, do the following:

1. Open the Consent Screen page in the Google API Console. If prompted, select a project or create a new one.
2. Fill out the form and click Save.