Stay organized with collections
Save and categorize content based on your preferences.
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.
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.
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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-03 UTC."],[[["\u003cp\u003eThe Google Ads API has frequent updates, including three major releases and sunsets annually, requiring you to keep your application current.\u003c/p\u003e\n"],["\u003cp\u003eUnversioned changes and feature deprecations are communicated through the API blog, sunset page, and potentially Mandatory Service Announcement emails, so ensure your contact information is up-to-date.\u003c/p\u003e\n"],["\u003cp\u003eStay informed about API changes and new features by following the official API blog and release notes, and consider saving the release notes page in your Google Developer Profile for update notifications.\u003c/p\u003e\n"],["\u003cp\u003eKeep track of the Google Ads product blog to remain aware of product changes and announcements that may affect your API usage.\u003c/p\u003e\n"]]],[],null,["# Stay updated with the Google Ads API\n\nThe Google Ads API changes frequently, and you should keep your application up to date\nwith the changes.\n\nAPI releases and sunsets\n------------------------\n\nThe Google Ads API usually has three major releases and three major release sunsets per\nyear. Three major releases are actively maintained at any one time, and the\nearlier versions are sunset with each new major release. You should invest\neffort to regularly upgrade your application. See our [release policy](/google-ads/api/docs/sunset-dates) to\nlearn more.\n\nThe matrix of client library versions and supported API versions can be found on\nthe [client library home page](/google-ads/api/docs/client-libs#supported_api_versions). For the Python client library, there is a\nmore [detailed dependency matrix](/google-ads/api/docs/client-libs/python/dependencies).\n\nFeature deprecations\n--------------------\n\nWhile the Google Ads API tries to align as many incompatible feature changes to version\nboundaries, this isn't always possible. In cases where it isn't possible to\nalign incompatible changes to version boundaries, the Google Ads API makes unversioned\nchanges.\n\nUnversioned changes are announced on the official [API blog](//ads-developers.googleblog.com/) and\nsummarized on the [sunset page](/google-ads/api/docs/sunset-dates). If this change affects your API calls or\nthe accounts that you manage, Google may send you a Mandatory Service\nAnnouncement email summarizing the change. Make sure you [keep your API contact\nemail updated](/google-ads/api/docs/productionize/shared-aliases#contact_email), so that you can receive these emails. In addition, follow\nthe official blog for any announcements.\n\nAnnouncements\n-------------\n\nAll changes related to the Google Ads API are announced on the [official blog](//ads-developers.googleblog.com/).\nYou should keep track of the blog to learn more about upcoming changes.\n\nChanges related to the Google Ads product are announced on the [official product\nblog](//blog.google/products/ads-commerce/). In addition to the API blog, you should follow the product blog to\nensure that you don't miss product changes and announcements.\n\nAll the changes related to a specific API release are explained in our [release\nnotes](/google-ads/api/docs/release-notes). If you have a [Google Developer Profile](/profile/help/overview), you can\n[save](/profile/help/saved-pages#receive_notifications) the release notes page in your profile and\n[receive notifications](/profile/help/saved-pages#save_a_page) when the page is updated, or on a periodic\nbasis. Individual releases are also announced on our [official blog](//ads-developers.googleblog.com/).\nKeep track of both these pages to learn more about new features in the Google Ads API."]]
