Tag Archives: dv360_api

Deprecation of Structured Data Files v6

Today we’re announcing the deprecation of Structured Data Files (SDF) v6. This version will sunset on April 30, 2025.

Migrate to SDF v7 or higher before the sunset date to avoid any interruption of service. Instructions on how to migrate from v6 to v7 can be found in our migration guide.

After April 30, 2025, the following changes will apply to all users:

  • The default version of partners and advertisers using those versions will be updated to v7.
  • sdfdownloadtasks.create requests using SDF_VERSION_6 in the request body will return a 400 error.

If you run into issues or need help with your migration, please contact us using our new Display & Video 360 API Technical support contact form.

Display & Video 360 API v2 will sunset on September 3, 2024

As announced in February 2024, Display & Video 360 API v2 will sunset on September 3, 2024. Please migrate to Display & Video 360 API v3 before the sunset date to avoid an interruption of service.

You can read our release notes for more information about v3. Follow the steps in our v3 migration guide to help you migrate from v2 to v3.

If you run into issues or need help with your migration, please contact us using our new Display & Video 360 API Technical support contact form.

Reminder: Entity Read Files sunset on October 31, 2024

On October 31, 2024, Display & Video 360 Entity Read Files (ERFs) will sunset. After this date, new private and public ERFs will not be generated. ERFs were deprecated in June 2021 and the October sunset date was first announced in January 2024.

If you are currently using ERFs to programmatically retrieve Display & Video 360 resource configurations, migrate to the Display & Video 360 API. You can either integrate directly with the Display & Video 360 API using REST requests or automatically import Display & Video 360 resource configurations into BigQuery using the Display & Video 360 API BigQuery Connector.

See our migration guide for more information on migrating to the Display & Video 360 API and the two integration options.

If you have questions or concerns about this migration, please contact us using our new Display & Video 360 API Technical support contact form.

June 2024 update to Display & Video 360 API

Today, we’re announcing the June 2024 update to the Display & Video 360 API. This update adds the following:

  • The ability to retrieve and manage keyword targeting assigned at the advertiser level.
  • The optimizationObjective field in the InsertionOrder resource. This field is only writable for allowlisted customers, and will otherwise be set as null.

More details about this update can be found in the Display & Video 360 API release notes. Before using these new features, make sure to update your client library to the latest version.

If you need help with these new features, please contact us using our new Display & Video 360 API Technical support contact form.

Deprecation of publisherReviewStatuses field in the Display & Video 360 API

Today we’re deprecating the publisherReviewStatuses field in the Display & Video 360 API Creative resource. The field will sunset on June 26, 2024. After the sunset, publisherReviewStatuses will always contain an empty array in retrieved Creative resources.

We’ve added the upcoming sunset to our list of feature deprecations. To avoid any issues, we recommend that you stop reading the publisherReviewStatuses field from retrieved Creative resources.

If you have questions regarding these changes, please follow the instructions on our support guide or contact us using our contact form.

Launching Structured Data Files QA format and v7.1

Today we’re announcing the general availability of the Structured Data Files (SDF) v7.1 and the open beta of our new QA format. Both are available to all Display & Video 360 users.

While in open beta, the QA format might be updated without notice. These updates will be reflected in the documentation. We will announce the QA format release to general availability at a later date.

What’s new in v7.1?

All users can now use SDF v7.1 to upload and download SDFs in the Display & Video 360 UI, and to download SDFs through the Display & Video 360 API.

The update from v7 to v7.1 includes the following changes:

  • Added new TrueView Video Ad settings to the Line Item resource.
  • Renamed three insertion order columns to use “Kpi” instead of “Performance Goal.”
  • Introduced a new objective column to the insertion order resource. This column is currently in beta and only available to participating clients.

Full details on the changes made in v7.1 can be found in our Structured Data Files release notes. If you are currently using SDF v5.5 or v6, follow the instructions on our v7 migration guide first before migrating to v7.1.

What’s the SDF QA format?

The new SDF QA format provides SDFs with human-readable data to make it easier to review Display & Video 360 resource settings in bulk.

All supported SDF versions offer this format through two new file types: Line Item - QA and YouTube Ad Group - QA. These file types provide the same information as standard format files of the same version, and convey a subset of that information using display name values instead of numeric IDs.

SDF QA files are read-only and cannot be uploaded to modify or create Display & Video 360 resources. Currently, QA format files are only available through the Display & Video 360 interface.

We are accepting feedback on the QA format while it is in open beta. To submit feedback, please use the Send Feedback button on the relevant reference documentation page. We will consider suggested updates before releasing the QA format to general availability.

If you run into issues or need help with this new format or version, please follow the instructions on our support guide or contact us using our contact form.

April 2024 update to Display & Video 360 API

Today we’re announcing the April 2024 update to the Display & Video 360 API. This update includes:

More details about this update can be found in the Display & Video 360 API release notes. Before using these new features, make sure to update your client library to the latest version.

If you need help with these new features, please contact us using our new Display & Video 360 API Technical support contact form.

Deprecation of Structured Data Files v5.5

Today we’re announcing the deprecation of Structured Data Files (SDF) v5.5. This version will sunset on October 3, 2024.

Migrate to v7, the most recent version, by the sunset date. Instructions on how to migrate to v7 can be found in our migration guide.

Once v5.5 is sunset:

  • The default version of partners and advertisers using those versions will be updated to the oldest supported version, v6.
  • sdfdownloadtasks.create requests using the sunset version in the request body will return a 400 error.

If you run into issues or need help with your migration, please contact us using our support contact form.

Adding new project-level quota to Display & Video 360 API

On April 2, 2024, the Display & Video 360 API will institute a new project-level quota of 1500 total (read and write) requests per minute per project and 700 write requests per minute per project to help protect our infrastructure and improve the stability of the API for the overall community. All Display & Video 360 API requests that a project makes will count towards this new quota.

This new quota will replace the existing general request quota limits and be enforced along with existing advertiser-specific request quota limits.

Most existing projects don’t exceed the new quota limit, and thus don’t need adjustments. However, if your existing integration can make concurrent API requests to 5 or more advertisers, you are at risk of exceeding this new quota limit and should take the following actions:
  • Update the error handling of your Display & Video 360 API integration to reduce request frequency when receiving 429 error responses.
  • Consider using the Display & Video 360 API BigQuery connector to retrieve Display & Video 360 resource configuration settings in bulk.
See our quota optimization guide for more suggestions on how to further optimize your current integration.

If you have questions about this new quota, please contact us using our support contact form.

February 2024 update to Display & Video 360 API

Today we’re announcing the February 2024 update to the Display & Video 360 API. This update includes the following features:

More details about this update can be found in the Display & Video 360 API release notes. Before using these new features, make sure to update your client library to the latest version.

If you need help with these new features, please contact us using our support contact form.