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 releases four new [major versions](https://developers.google.com/google-ads/api/docs/concepts/versioning) throughout the year,
as well as periodic minor versions, and sunsets earlier versions after their
support window expires. Invest effort to regularly upgrade your application. See
our [deprecation and sunset schedule](https://developers.google.com/google-ads/api/docs/sunset-dates) for active versions and
sunset dates.

The matrix of client library versions and supported API versions can be found on
the [client library home page](https://developers.google.com/google-ads/api/docs/client-libs#supported-api-versions). For the Python client library,
there is a more [detailed dependency matrix](https://developers.google.com/google-ads/api/docs/client-libs/python/dependencies).

## Feature deprecations

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

Unversioned changes are announced on the official
[API blog](https://ads-developers.googleblog.com/) and summarized on the
[sunset page](https://developers.google.com/google-ads/api/docs/sunset-dates). 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](https://developers.google.com/google-ads/api/docs/productionize/shared-aliases#contact_email), so that you can receive
these emails. In addition, follow the official blog for any announcements.

## Announcements

All changes related to the Google Ads API are announced on the
[official API blog](https://ads-developers.googleblog.com/). 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](https://blog.google/products/ads-commerce/). 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](https://developers.google.com/google-ads/api/docs/release-notes). If you have a
[Google Developer Profile](https://developers.google.com/profile/help/overview), you can
[save the release notes page](https://developers.google.com/profile/help/saved-pages#save-a-page) in your profile and
[receive notifications](https://developers.google.com/profile/help/saved-pages#receive-notifications) when the page is updated, or on a
periodic basis. Individual releases are also announced on our
[official API blog](https://ads-developers.googleblog.com/). Keep track of both these pages to learn
more about new features in the Google Ads API.