Announced Deprecations

This page lists the deprecation and sunset dates for API versions and individual features in the Display & Video 360 API.

Deprecations and sunset dates for the API will also be announced on the Google Ads developer blog.

Version Deprecations

Display & Video 360 API versions are released, deprecated, and sunset regularly. These steps are defined as follows:

  • Release: The version exits any alpha or beta status and is considered stable. Feature additions may still be released for the version.
  • Deprecation: The version is being retired and an end of support (sunset) date is announced. Users must migrate to a newer version before the sunset date. Feature additions will no longer be released for the version.
  • Sunset: The version is no longer supported. Requests made to the version return an error.

The table below lists all existing core Display & Video 360 API versions, their release dates, and their deprecation and sunset dates, if announced.

API Version Release Date Deprecation Date Sunset Date Migration Guide
v3 October 31, 2023
v2 December 6, 2022 February 15, 2024 September 3, 2024 Migrate from v2 to v3
v1 March 9, 2020 March 13, 2023 September 14, 2023 Migrate from v1 to v2

Feature Deprecations

Follow our Google Ads developer blog for announcements of upcoming significant feature deprecations.

The table below lists all announced feature deprecations, providing the initial effective date and a description of the deprecation with recommended actions and links to relevant documentation:

Feature Initial Effective Date Description
Targeting Expansion March 25, 2023 Replacement of the targeting expansion feature with optimized targeting, rolled out gradually from March 25, 2023 to early May 2023. Relevant changes to Display & Video 360 API and Structured Data Files behavior as well as recommended actions were announced in a blog post.
Manual Triggers May 17, 2023

Timeline:

  • May 17, 2023: Line items using manual triggers will stop serving in Display & Video 360. If you activate a manual trigger linked to an active line item after this date, the line item won't serve ads.
  • August 1, 2023: advertisers.manualTriggers service in DV360 API v1 and v2, LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER enum value in DV360 API v1, and the LineItemFlight.triggerId field in DV360 API v1 will sunset. After this date, requests made to these services or to these fields will return an error.

Recommended actions:

Installed App and New Mobile Devices GoogleAudience Types May 20, 2023

Timeline:

  • May 20, 2023: You will no longer be able to assign GoogleAudience resources with a GoogleAudienceType of GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS or GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES to line item or insertion order audience targeting. Requests assigning these audiences to a line item's audience targeting will return an error. This includes advertisers.lineItems.duplicate and advertisers.lineItems.generateDefault requests, if the created line item would include deprecated audiences in its audience targeting.
  • June 8, 2023: Impacted audiences will be removed from all line item and insertion order targeting and from all combined audiences. If a line item is not able to serve ads when these audiences are removed, they will be paused. On this date, these audiences will also no longer be retrievable using the googleAudiences service.

Recommended Tasks:

  • We recommend that you immediately stop using impacted audiences when making future updates to your line item targeting.
  • Remove all impacted audiences from existing line item and insertion order targeting. Read about updating audience targeting in our Target Audiences guide.
Activity Based and Frequency Cap FirstAndThirdPartyAudience Types May 20, 2023

Timeline:

  • May 20, 2023: You will no longer be able to assign FirstAndThirdPartyAudience resources with a AudienceType of ACTIVITY_BASED or FREQUENCY_CAP to line item or insertion order audience targeting. Requests assigning these audiences to a line item's audience targeting will return an error. This includes advertisers.lineItems.duplicate and advertisers.lineItems.generateDefault requests, if the created line item would include deprecated audiences in its audience targeting.
  • June 8, 2023: Impacted audiences will be removed from all line item and insertion order targeting and from all combined audiences. If a line item is not able to serve ads when these audiences are removed, they will be paused. On this date, these audiences will also no longer be retrievable using the firstAndThirdPartyAudiences service.

Recommended Tasks:

  • We recommend that you immediately stop using impacted audiences when making future updates to your line item targeting.
  • Remove all impacted audiences from existing line item and insertion order targeting. Read about updating audience targeting in our Target Audiences guide.
Existing API Quota Limits May 30, 2023

On May 30, 2023, existing usage limits will be replaced with a hybrid quota structure that does the following:

  1. Eliminates the requests per day per project quota.
  2. Institutes a requests per minute per advertiser per project quota for qualifying methods.

These new limits will allow greater flexibility in API usage and enable parallelization of requests across advertisers. Details of this change are in our existing quota limit documentation.

OR operator usage between restrictions of different fields in LIST filters

June 21, 2023

On June 21, 2023, LIST request filter parameters will no longer allow OR logical operators to be used between restrictions of different fields.

For example, resources identified with filter string lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" OR insertionOrderId="123" must instead be retrieved using two LIST requests with the following filter strings:

  • lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT"
  • insertionOrderId="123"

Reference our how-to guide on filtering LIST requests for more details on the restrictions of logical operators.

Review the filter query parameters of all your existing LIST calls and verify that they are using the OR logical operator correctly before June 21, 2023 to avoid an interruption of service.

Ability to filter or order list requests by budget.budget_segments.date_range.end_date and flight.dateRange.endDate fields

Initial Effective Date updated

June 21, 2023

On June 21, 2023, budget.budget_segments.date_range.end_date and flight.dateRange.endDate will no longer be accepted fields in advertisers.insertionOrders.list and advertisers.lineItems.list filter and orderBy query parameters, respectively. After this date, requests using these fields in the filter and orderBy query parameters will return an error.

Remove all filter and order logic using these two fields before June 21, 2023 to avoid an interruption of service.

Ability to filter advertisers.lineItems.list requests by four additional fields June 21, 2023

On June 21, 2023, advertisers.lineItems.list will no longer support filtering by the following fields:

  • flight.triggerId
  • targetedChannelId
  • targetedNegativeKeywordListId
  • warningMessages

Remove all filter logic using these four fields before June 21, 2023 to avoid an interruption of service.

Outcome based buying August 1, 2023

On August 1, 2023, insertion orders using outcome based buying, defined by a billableOutcome field value of BILLABLE_OUTCOME_PAY_PER_CLICK or BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION, and their child line items will be archived.

This change will affect the following requests:

publisherReviewStatuses field in creative resources June 26, 2024

Starting on June 26, 2024, the publisherReviewStatuses field will sunset and will be empty when retrieving Creative resources.

Content targeting for YouTube & Partners line items September 30, 2024

On September 30, 2024, the following values for the identified targeting types will sunset for YouTube & Partners line items:

Sunset targeting options will automatically be removed from existing line item targeting. These values will still be available for use in advertiser-level targeting.

To avoid any interruption of service, remove this targeting from any existing YouTube & Partners line items before the sunset date.

Oracle first- and third-party audiences September 30, 2024

On September 30, 2024, FirstAndThirdPartyAudience resources sources from Oracle will sunset. Upon sunset, these audiences will be removed from any existing resource targeting and combined audience. If a line item either only targets sunset audiences or negatively targets any sunset audiences, this update will automatically pause that line item.

To avoid any interruption of service, identify and remove any Oracle audiences from existing line item audience targeting and combined audiences before the sunset date.

Line item optimized targeting for a subset of bid strategies September 30, 2024

On September 30, 2024, LineItem resources using a subset of bid strategies will no longer be compatible with optimized targeting. With this change, LineItem resources with targetingExpansion.enableOptimizedTargeting set to True and bidStrategy.maximizeSpendAutoBid.performanceGoalType set to BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA, BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN, or BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED or bidStrategy.performanceGoalAutoBid.performanceGoalType set to BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM will be updated to set targetingExpansion.enableOptimizedTargeting to False.

To avoid any interruption of service, update and verify that your line items using these bid strategies don't have optimized targeting turned on.

Flight ASAP Pacing for insertion orders November 5, 2024

On November 5, 2024, PACING_TYPE_ASAP will no longer be compatible with PACING_PERIOD_FLIGHT when setting the insertion order pacing field. The pacingType for all existing insertion orders with this configuration will be updated to PACING_TYPE_AHEAD.

To avoid any interruption of service, update the pacing of any existing insertion orders using PACING_TYPE_ASAP and PACING_PERIOD_FLIGHT.