Frequently Asked Questions

Who can access the Structured Data Files (SDF) Upload API pilot features?

The advertisers.sdfuploadtasks.upload method is only available to Google Cloud projects added to an allowlist.

What API versions support pilot features?

The SDF Upload API pilot is only supported in Display & Video 360 API v4.

How can I tell if my project has been added to the allowlist?

Insert an API key generated from your project in this URL, then copy and paste the URL into your browser:

Tip: To select an API key from your project, click the API_KEY element in the URL. If an API key doesn't exist for the selected project, you'll be prompted to create one.

https://displayvideo.googleapis.com/$discovery/rest?version=v4&labels=SDF_UPLOAD_ALPHA&key=API_KEY

If you see a JSON description of the API, your project has been added to the allowlist. If you see an error, then you project has not been added.

What client libraries are supported?

Only the Google API Client Library for Python can be used to access the { api_name } pilot features. See our configuration steps to create an authorized service object that can utilize pilot features.

Are there limits to how many SDFs I can upload?

A Google Cloud project can only use the Display & Video 360 API to upload five SDFs per advertiser in a day. The day is dictated by the advertiser's timezone.

If an advertisers.sdfuploadtasks.upload request fails or an upload `Operation finishes in error, the attempt is not counted against the relevant quota.

Why am I receiving a 429 error?

If you are receiving a 429 error, you have likely exceeded the number of SDFs you can upload under an advertiser in a single day. Wait until the following day before using the Display & Video 360 API to upload additional SDFs under the relevant advertiser.

If you believe you are exceeding a different quota, see our standard API usage limits for limit definitions and our quota optimization guide for best practices on limiting quota usage.