Stay updated with the Google Ads API

The Google Ads API changes frequently, and you should keep your application up to date with the changes.

API releases and sunsets

The Google Ads API usually has three major releases and three major release sunsets per year. Three major releases are actively maintained at any one time, and the earlier versions are sunset with each new major release. You should invest effort to regularly upgrade your application. See our release policy to learn more.

The matrix of client library versions and supported API versions can be found on the client library home page. For the Python client library, there is a more detailed dependency matrix.

Feature deprecations

While the Google Ads API tries to align as many incompatible feature changes to version boundaries, this isn't always possible. In cases where it isn't possible to align incompatible changes to version boundaries, the Google Ads API makes unversioned changes.

Unversioned changes are announced on the official API blog and summarized on the sunset page. If this change affects your API calls or the accounts that you manage, Google may send you a Mandatory Service Announcement email summarizing the change. Make sure you keep your API contact email updated, so that you can receive these emails. In addition, follow the official blog for any announcements.


All changes related to the Google Ads API are announced on the official blog. You should keep track of the blog to learn more about upcoming changes.

Changes related to the Google Ads product are announced on the official product blog. In addition to the API blog, you should follow the product blog to ensure that you don't miss product changes and announcements.

All the changes related to a specific API release are explained in our release notes. If you have a Google Developer Profile, you can save the release notes page in your profile and receive notifications when the page is updated, or on a periodic basis. Individual releases are also announced on our official blog. Keep track of both these pages to learn more about new features in the Google Ads API.