Frequently Asked Questions

Page Summary

• The daily SDF upload limit per advertiser for this pilot feature has increased from five to thirty.

• Access to the SDF Upload API pilot features and the advertisers.sdfuploadtasks.upload method is restricted to Google Cloud projects on an allowlist.

• The SDF Upload API pilot is exclusively supported in Display & Video 360 API v4 and recommends using SDF v9.

• You can check if your project is on the allowlist by inserting your API key into a specific URL and checking for a JSON description of the API.

• Only the Google API Client Library for Python supports the SDF Upload API pilot features.

• A single Display & Video 360 user can process up to 20 SDF upload tasks concurrently, with each request handling one file.

• A 429 error likely indicates exceeding the daily SDF upload limit per advertiser.

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

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.2 when using the SDF Upload API pilot. See the v9 migration guide if you are migrating from a version earlier than 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:

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 entries can be in a SDF?

SDFs have a limit of 10,000 entries. Attempting to upload files exceeding this limit will result in an error.

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.