Display & Video 360 API SDF Upload pilot

Page Summary

• The upload limit for this pilot feature has been increased from five to thirty SDFs a day per advertiser.

• This pilot allows customers to upload Structured Data Files (SDFs) using a new Display & Video 360 API beta feature.

• To use the pilot features, you must enroll your Google Cloud project, generate an API key, and configure your client using the Google API Client Library for Python.

• Instructions on how to start uploading Structured Data Files can be found in the feature guide.

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. Each file can contain a maximum of 10,000 entries.

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

Only customers who have requested and been granted access to the pilot can use the pilot features.

Warning: At this time, we have stopped enrolling new customers into the pilot. New requests to be added to the pilot will be denied.

Confirm with your Google sales representative that your Google Cloud project ID is enrolled in the pilot 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.