Register for one of our Google Ads API Migration Workshops (October 5, 2021 - October 14, 2021)

Deprecation Schedule

API version deprecations

See our versioning guide to learn how versioning works.

With the release of a new version, a deprecated version may be given a sunset date, after which that version will no longer be available. Our client libraries support all available versions of all services. You can gradually migrate by specifying different versions for different services.

The table below lists the specific deprecation and sunset dates for each available version. We encourage you to migrate to the newest version as soon as feasible after its release.

API version Release date Deprecation date Sunset date Migration guide
v12 October/November 2022 June/July 2023
v11 June/July 2022 March/April 2023
v10 February/March 2022 October/November 2022
v9 October/November 2021 June/July 2022
v8 June 09, 2021 October 27, 2021 March/April 2022
v7 April 28, 2021 September 8, 2021 January/February 2022 Migrating from v7 to v8

Feature deprecations

Subscribe to the Google Ads developer blog to be the first to hear about upcoming feature deprecations.

The table below lists the specific feature deprecations that are currently planned for the Google Ads API. More details for each deprecation can be found in the linked blog posts.

Feature Description Effective Date Additional Notes
Target CPA and Target ROAS standard bidding strategies in Search campaigns This change will prevent creating new Search campaigns that use these strategies, as well as prevent updating existing Search campaigns to use these strategies. September 30, 2021 Instead of these bidding strategies, use the new optional target CPA field with MaximizeConversions, and the new target ROAS field with MaximizeConversionValue. This change will not affect portfolio (shared) bidding strategies.
Feed-based extensions (first batch)

Feed-based extensions will be replaced by asset-based extensions for the following types:

  • Lead Form
  • Promotion
  • Callout
  • Sitelink
  • Structured Snippet
October 20, 2021 Feed-based extensions will automatically migrate to Asset-based extensions on October 20, 2021, unless the CID has opted out. Check out the documentation for more details on migrating and opting out of auto-migration.
Feed-based extensions (second batch)

Feed-based extensions will be replaced by asset-based extensions for the following types:

  • App
  • Call
  • Hotel Callout
  • Price
February 15, 2022 Feed-based extensions will automatically migrate to Asset-based extensions on February 15, 2021. Check out the documentation for more details on migrating.
Call Only Ads Call Only Ads are replaced by Call Ads in v8 of the Google Ads API. Call Only Ads will continue to serve until they are sunset. April 27, 2022 You can still create Call Only Ads in the AdWords API v201809 and the Google Ads API v7, but we encourage you to use v8 to create new Call Ads.
Expanded text ads Expanded text ads have been deprecated and starting June 30, 2022, you'll no longer be able to create or edit them. June 30, 2022 After the sunset, expanded text ads will continue to serve, and you'll still see reports on their performance going forward. You'll still be able to pause, resume, or remove them if needed. However, we strongly encourage you to transition to responsive search ads.