Get started

The Display & Video 360 API is the programmatic interface for the Display & Video 360 platform. It allows developers to easily and efficiently automate complex Display & Video 360 workflows, such as creating insertion orders and setting targeting options for individual line items.

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

Prerequisites

Before using the Display & Video 360 API, there are a few prerequisite steps you'll need to satisfy:

  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.

Create a project

To get started using the Display & Video 360 API, you need to first create or select a project in the Google API Console and enable the API. Using this link guides you through the process and activates the Display & Video 360 API automatically.

Use an existing project

The following steps apply to users who have an existing project and prefer to activate the Display & Video 360 API for it manually.

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 Other when prompted to select an application type and 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 will not 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.
  5. 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.

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.