Page Summary

outlined_flag

• When a new API version is released, a deprecated version is given a sunset date after which it will no longer be available.

• Google aims to keep at most four major versions available at any time, with major versions lasting around 12 months and minor versions around 10 months.

• You will need to perform at most two upgrades per year, and you can upgrade directly to a non-sequential later version.

• There is at least a 20-week overlap between the release of client libraries for the latest version and the sunset date of the version being retired.

• You can view the Google Ads API versions used by your project in the Google Cloud Console under APIs & Services.

• Deprecated versions are still usable but not the latest, while sunset versions are no longer functional and require an immediate upgrade.

• The timetable provides specific release, deprecation, and tentative sunset dates for available API versions, encouraging upgrades to the latest version.

• Specific client library versions support different Google Ads API versions as detailed in the provided tables for various programming languages.

• Feature deprecations, such as changes to conversion environment usage and handling of gclid/gbraid values, are also announced with effective dates and details on the developer blog.

With the release of a newversion, a deprecatedversion is given a sunset date, after which that version will no longer beavailable. Here are some other guidelines to keep in mind:

• We strive to keep at most four major versions available at any one time.
• Major versions have a lifespan of around12 months—minorversions: 10 months.
• You'll have to perform at mosttwo upgrades per year, and you don't haveto upgrade in strict sequential order—for instance, you can upgradefrom version (N) directly to version (N+2).
• The overlap between the date when all client libraries are released for thelatest version and the version to be sunset is at least 20 weeks.

Ourclient libraries support any available versions of aservice, so you can gradually upgrade by specifying different versions of usedservices.

Timetable

The following table lists the specific deprecation and sunset dates for eachavailable version, and projected release dates for future versions. Weencourage you to upgrade to the latest version as soon as feasible after itsrelease. The tentative date means that the sunset could happen any time in thatmonth, and the dates could change.Subscribe to the blogfor API version sunset announcement reminders.

* v26.1 is designated as an optional release due to overlap withthe holiday season.

View the versions your project is using

You can view a list of methods and services your project has recently calledusing theGoogle Cloud Console:

1. Open theAPIs & Services in the Google Cloud Console.
2. ClickGoogle Ads API in the table.
3. On theMETRICS subtab, you should see your recent requests plotted oneach graph. You can see which methods you've sent requests to in theMethods table. The method nameincludes a Google Ads API version, a service, and a method name, such asgoogle.ads.googleads.v23.services.GoogleAdsService.Mutate.
4. (Optional) Choose the timeframe you want to view for your requests.

Differences between deprecation and sunset

Supported client library versions

The table shows which client libraries work with which API versions.

Feature deprecations

Regularly monitor theGoogle Ads developer blogto be the first to hear about upcoming feature deprecations.

The following table lists the specific feature deprecations that areplanned for the Google Ads API. More details for each deprecation can be found in thelinked blog posts.