Tag Archives: update

Promotion of Structured Data Files QA format to general availability

Today we’re announcing the promotion of the Structured Data Files (SDF) QA format to general availability.

The SDF QA Format was initially released in open beta on May 30, 2024. The QA format allows you to download SDFs for Line Item and YouTube Ad Group resources that use human-readable values, such as display names, in place of numeric IDs to make it easier to review resource settings in bulk. These QA format files are read-only and can’t be uploaded to modify or create Display & Video 360 resources.

The two new file types using this format are Line Item - QA and YouTube Ad Group - QA and are available in SDF v6 and later. These files can be downloaded in the Display & Video 360 interface or by using Display & Video 360 API v3, by either:

To help you decide whether the SDF QA format is right for you and your integration, we’ve added information and recommendations to the existing Bulk Tools guide.

If you run into issues, please contact us using our new Display & Video 360 API Technical support contact form.

- Trevor Mulchay, Display & Video 360 API Team

Instant reports will soon be available using Bid Manager API

In the upcoming months, Display & Video 360 instant reports will be made available using the Bid Manager API. We previously announced the migration of certain report types from Offline Reporting to Instant Reporting.

Once a partner is migrated, they will see the following changes:

  • Instant reports will be included in queries.list responses.
  • Existing Standard, Reach, YouTube, and URA reports will only be available under the Instant Reporting tab in the Display & Video 360 interface under the same query and report IDs.
  • If you use the Display & Video 360 interface to build new reports, you will need to build Standard, Reach, YouTube, and URA reports under the Instant Reporting tab.

This migration will happen by partner throughout the following months, with all reports under a partner migrated at once.

If you have questions about this migration in general, you can contact Display & Video 360 product support using this contact form. If you have questions about how this migration will impact the API, please contact us using our new Bid Manager API Technical support contact form.

- Trevor Mulchay, Bid Manager API Team

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.

- Trevor Mulchay, Display & Video 360 API Team

Changes to how you contact “Content API for Shopping” Support

What's Happening?

As we continue to improve our support experience, we are making changes to how you contact the Content API for Shopping support team.

What's Changing?

How you contact “Content API for Shopping” Support:

  • Shutting down current support path: Effective June 10, 2024, the support email address (shopping-api-support) and the Developer Forum will no longer accept support questions.
  • New support paths:
    • To reach our “Content API for Shopping” support team, please use our new Contact Us Form: link here
    • To reach our "Comparison Shopping Services API" support team, please use this Contact Us Form: link here
    • Going forward, these will be the only support paths available.

This change will help us better understand user needs and provide quicker solutions. We appreciate your partnership.

In the meantime, please reference the following sites for integration/API information:

Your Content API for Shopping Team

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.

- Trevor Mulchay, Display & Video 360 API Team

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.

- Trevor Mulchay, Display & Video 360 API Team

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.
- Trevor Mulchay, Display & Video 360 API Team

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.

- Trevor Mulchay, Display & Video 360 API Team

January 2024 update to Display & Video 360 API

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

More detailed information 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.

- Trevor Mulchay, Display & Video 360 API Team

Update to Display & Video 360 API Terms of Service to ensure Online Behavior Advertising compliance

On February 9, 2024, we will update the Display & Video 360 API Terms of Service to add new language that supports announced changes to promote advertiser transparency and content reporting in Display & Video 360.

The new language specifies that, by setting the Advertiser resource field obaComplianceDisabled to true, you are attesting to using an alternative ad badging, transparency, and reporting solution for ads served in the European Economic Area (EEA) such that the following requirements are met:

  • The alternative solution includes any required transparency information and a mechanism for reporting illegal content.
  • You notify Google of any illegal content reports using this form.

The obaComplianceDisabled field description will also be updated to reflect this change.

If you have questions regarding these changes, please contact us using our support contact form.

- Trevor Mulchay, Display & Video 360 API Team