Starting September 8, 2025, every new line item will need to declare whether or not they will serve Eurpoean Union (EU) political ads. Display & Video 360 API and SDF uploads that don't provide declarations will fail. See our deprecations page for more details on how to update your integration to make this declaration.

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.

What SDF versions does the pilot support?

We recommend that you use SDF v9 when using the SDF Upload API pilot. See the v9 migration guide for more information about migrating to SDF v9.

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:

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 thirty SDFs per advertiser in a day. A day starts at midnight in the US Pacific timezone (PST).

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

How many SDFs can be uploaded at a time?

Each advertisers.sdfuploadtasks.upload request can only upload a single file.

A single Display & Video 360 user can only have 20 SDF upload tasks processing at a time. If you have uploaded 20 files, you must wait until one of the files is finished processing before uploading another.

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.