Display & Video 360 API SDF Upload pilot

Important: We have increased the upload limit for this pilot feature from five to thirty SDFs a day per advertiser.

This pilot provides a way for customers to test the new Display & Video 360 API beta feature allowing customers to upload Structured Data Files (SDFs) using the Display & Video 360 API.

This pilot allows each enrolled Google Cloud project to upload a maximum of thirty SDFs a day under an advertiser.

See our Upload SDFs guide for instructions on how to use the pilot feature.

Get Started

After you get started with the Display & Video 360 API, complete these steps in order to use pilot features.

Enroll your Google Cloud project in the pilot

If you are on this site, your Google Cloud project should already be enrolled in the pilot.

Please confirm that you have provided your Google Cloud project ID and Display & Video 360 partner ID to our team before trying to use the pilot features.

Generate an API key

In addition to standard Display & Video 360 API credentials, you must use an API key. Generate an API key for your Google Cloud project to use in your client configuration.

Configure your client

Use the Google API Client Library for Python to access these pilot features.

Here's how to install and configure your client library to make requests to the pilot features:

Python

1. Install the google-api-python-client

   pip install --upgrade google-api-python-client
   

2. Import the necessary libraries.

   from google_auth_oauthlib.flow import InstalledAppFlow
   from googleapiclient import discovery

3. Load the client secrets file and generate authorization credentials.

   Note: The first time you perform this step, you are asked to accept an authorization prompt in your browser. Before accepting, make sure you're signed in with a Google Account that has access to Display & Video 360. Your app will be authorized to access data on behalf of whichever account is signed in. See our Authorize Requests guide for more details on Display & Video 360 user permissions.

   # Set up a flow object to create the credentials using the
   # client secrets file and OAuth scopes.
   credentials = InstalledAppFlow.from_client_secrets_file(
       path-to-client-secrets-file,
       oauth-scopes).run_local_server()

4. Create an authorized service object using the discovery service.

   api_key = "API_KEY"
   api_name = "displayvideo"
   api_url = f"https://{api_name}.googleapis.com"
   api_version = "v4"
   api_label = "SDF_UPLOAD_ALPHA"
   
   discovery_url = (
       f"{api_url}/$discovery/rest?key={api_key}&version={api_version}&labels={api_label}"
   )
   
   service = discovery.build(api_name, api_version,
                             discoveryServiceUrl=discovery_url,
                             credentials=credentials)

Start uploading SDFs

Follow the instructions in our feature guide to start uploading Structured Data Files.