Migrate from v3 to v4

Last update: 2025-02-13

Warning: v4 is in open beta. Breaking changes may be made to v4 while in beta and will be listed in the Display & Video 360 API release notes. This document is updated regularly to reflect the live beta version.

Migrate your application

Migrating from v3 to v4 requires updating your endpoint URLs to call v4 and updating your application to account for breaking changes.

Update your API calls from v3 to v4

To use v4 instead of v3, update your requests to use new v4 endpoints.

For example, to call the advertisers.get method with v3, use the following URL:

GET https://displayvideo.googleapis.com/v3/advertisers/advertiserId

For v4, update the URL to the following:

GET https://displayvideo.googleapis.com/v4/advertisers/advertiserId

If you are using a client library to make requests to the API, use the most recent version of the client library and update your configuration to use v4.

Make required changes

We're introducing a number of breaking changes in v4. Review the following instructions and make the required changes relevant to your existing use of the Display & Video 360 API.

Update calls regarding first- and third-party audience resources and related targeting

FirstAndThirdPartyAudience resources have been replaced by FirstPartyAndPartnerAudience resources.

This change requires you to update the following:

• References to FirstAndThirdPartyAudience resources to use the new FirstPartyAndPartnerAudience resource.
• Existing requests to methods in the v3 service firstAndThirdPartyAudiences to the new v4 service firstPartyAndPartnerAudiences.
• Expectations of the default page size for firstPartyAndPartnerAudiences.list requests from 100 to 5000 items.
• References to the v3 firstAndThirdPartyAudienceType field to the new v4 firstPartyAndPartnerAudienceType field, using the new FirstPartyAndPartnerAudienceType enum type, with old values corresponding to the following new values:
  • FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY to TYPE_FIRST_PARTY
  • FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_THIRD_PARTY to TYPE_PARTNER

• References to AudienceType enum value LICENSED to instead use one of the following new, more specific values:

  • THIRD_PARTY
  • COMMERCE
  • LINEAR

• References to AssignedTargetingOption resources of TargetingType TARGETING_TYPE_AUDIENCE_GROUP to replace the v3 fields in AudienceGroupAssignedTargetingOptionDetails with the following new v4 fields:

  • excludedFirstAndThirdPartyAudienceGroup with excludedFirstPartyAndPartnerAudienceGroup
  • includedFirstAndThirdPartyAudienceGroups with includedFirstPartyAndPartnerAudienceGroups

Update existing ad group bulk list targeting requests

advertisers.adGroups.bulkListAdGroupAssignedTargetingOptions has been renamed advertisers.adGroups.bulkListAssignedTargetingOptions. Update your existing requests to use the new method name.

Include an optimization objective when creating insertion orders

optimizationObjective is now a required field in the InsertionOrder resource. Update your advertisers.insertionOrders.create requests to verify that this field is set.

Remove any requests to manage or retrieve campaign or insertion order targeting

The ability to retrieve or manage campaign or insertion order targeting has been removed. Remove any requests to the following services or methods:

• advertisers.campaigns.targetingTypes.assignedTargetingOptions service
• advertisers.insertionOrders.targetingTypes.assignedTargetingOptions service
• advertisers.campaigns.listAssignedTargetingOptions method
• advertisers.insertionOrders.listAssignedTargetingOptions method

Remove references to the creative resource field publisherReviewStatuses

The publisherReviewStatuses field has been removed from the ReviewStatusInfo object under the Creative resource after being deprecated in June 2024.