With the release of a new [version](https://developers.google.com/google-ads/api/docs/concepts/versioning), a deprecated
version is given a sunset date, after which that version will no longer be
available. Here are some other guidelines to keep in mind:

- We strive to keep at most five major versions available at any one time.
- *Major* versions have a lifespan of around **12 months** ---*minor* versions: 10 months.
- You'll have to perform at most **two upgrades per year**, and you don't have to upgrade in strict sequential order --- for example, you can upgrade from version (N) directly to version (N+2).

Our [client libraries](https://developers.google.com/google-ads/api/docs/client-libs) support any available versions of a
service, so you can gradually upgrade by specifying different versions of used
services.

## Timetable

The following table lists the specific deprecation and sunset dates for each
available version, and projected release dates for future versions. We encourage
you to upgrade to the latest version as soon as feasible after its release. The
tentative date means that the sunset could happen any time in that month, and
the dates could change. [Subscribe to the
blog](https://ads-developers.googleblog.com/2024/09/subscribe-to-blog.html) for API
version sunset announcement reminders.

> [!TIP]
> **Interactive API diff tool:** Compare field, method, and resource changes between versions using the filterable [proto difference
> tables](https://developers.google.com/google-ads/api/docs/upgrade#proto-differences-between-v25-v26) on the upgrade guide.

| API version | Release date | Sunset date | Breaking changes \& upgrade | Features and updates | Proto difference table |
| Released versions ||||||
|---|---|---|---|---|---|
| **[v23](https://developers.google.com/google-ads/api/docs/release-notes#v23-2026-01-28)** | January 28, 2026 | February 2027 | [v23 breaking changes](https://developers.google.com/google-ads/api/docs/release-notes#v23-breaking-changes) ([upgrade guide](https://developers.google.com/google-ads/api/docs/upgrade#v22-v23)) | [v23 features and updates](https://developers.google.com/google-ads/api/docs/release-notes#v23-features-updates) | [v22 versus v23 proto diffs](https://developers.google.com/google-ads/api/docs/upgrade#proto-differences-between-v22-v23) |
| [v23.1](https://developers.google.com/google-ads/api/docs/release-notes#v23-1-2026-02-25) | February 25, 2026 | February 2027 | None (minor release) | [v23.1 features and updates](https://developers.google.com/google-ads/api/docs/release-notes#v23-1-2026-02-25) | [v22 versus v23 proto diffs](https://developers.google.com/google-ads/api/docs/upgrade#proto-differences-between-v22-v23) |
| [v23.2](https://developers.google.com/google-ads/api/docs/release-notes#v23-2-2026-03-25) | March 25, 2026 | February 2027 | None (minor release) | [v23.2 features and updates](https://developers.google.com/google-ads/api/docs/release-notes#v23-2-2026-03-25) | [v22 versus v23 proto diffs](https://developers.google.com/google-ads/api/docs/upgrade#proto-differences-between-v22-v23) |
| [v23.3](https://developers.google.com/google-ads/api/docs/release-notes#v23-3-2026-06-24) | June 24, 2026 | February 2027 | None (minor release) | [v23.3 features and updates](https://developers.google.com/google-ads/api/docs/release-notes#v23-3-2026-06-24) | [v22 versus v23 proto diffs](https://developers.google.com/google-ads/api/docs/upgrade#proto-differences-between-v22-v23) |
| **[v24](https://developers.google.com/google-ads/api/docs/release-notes#v24-2026-04-22)** | April 22, 2026 | May 2027 | [v24 breaking changes](https://developers.google.com/google-ads/api/docs/release-notes#v24-breaking-changes) ([upgrade guide](https://developers.google.com/google-ads/api/docs/upgrade#v23_2-v24)) | [v24 features and updates](https://developers.google.com/google-ads/api/docs/release-notes#v24-features-updates) | [v23 versus v24 proto diffs](https://developers.google.com/google-ads/api/docs/upgrade#proto-differences-between-v23-v24) |
| [v24.1](https://developers.google.com/google-ads/api/docs/release-notes#v24-1-2026-05-13) | May 13, 2026 | May 2027 | None (minor release) | [v24.1 features and updates](https://developers.google.com/google-ads/api/docs/release-notes#v24-1-2026-05-13) | [v23 versus v24 proto diffs](https://developers.google.com/google-ads/api/docs/upgrade#proto-differences-between-v23-v24) |
| [v24.2](https://developers.google.com/google-ads/api/docs/release-notes#v24-2-2026-06-24) | June 24, 2026 | June 2027 | None (minor release) | [v24.2 features and updates](https://developers.google.com/google-ads/api/docs/release-notes#v24-2-2026-06-24) | [v23 versus v24 proto diffs](https://developers.google.com/google-ads/api/docs/upgrade#proto-differences-between-v23-v24) |
| **[v25](https://developers.google.com/google-ads/api/docs/release-notes#v25-2026-07-22)** | July 22, 2026 | August 2027 | [v25 breaking changes](https://developers.google.com/google-ads/api/docs/release-notes#v25-breaking-changes) ([upgrade guide](https://developers.google.com/google-ads/api/docs/upgrade#v24_2-v25)) | [v25 features and updates](https://developers.google.com/google-ads/api/docs/release-notes#v25-features-updates) | [v24 versus v25 proto diffs](https://developers.google.com/google-ads/api/docs/upgrade#proto-differences-between-v24-v25) |
| [v25.1](https://developers.google.com/google-ads/api/docs/release-notes#v25-1-2026-08-19) | August 19, 2026 | August 2027 | None (minor release) | [v25.1 features and updates](https://developers.google.com/google-ads/api/docs/release-notes#v25-1-2026-08-19) | [v24 versus v25 proto diffs](https://developers.google.com/google-ads/api/docs/upgrade#proto-differences-between-v24-v25) |
| [v25.2](https://developers.google.com/google-ads/api/docs/release-notes#v25-2-2026-09-23) | September 23, 2026 | August 2027 | None (minor release) | [v25.2 features and updates](https://developers.google.com/google-ads/api/docs/release-notes#v25-2-2026-09-23) | [v24 versus v25 proto diffs](https://developers.google.com/google-ads/api/docs/upgrade#proto-differences-between-v24-v25) |
| **[v26](https://developers.google.com/google-ads/api/docs/release-notes#v26-2026-10-14)** (Latest) | October 14, 2026 | November 2027 | [v26 breaking changes](https://developers.google.com/google-ads/api/docs/release-notes#v26-breaking-changes) ([upgrade guide](https://developers.google.com/google-ads/api/docs/upgrade#v25_2-v26)) | [v26 features and updates](https://developers.google.com/google-ads/api/docs/release-notes#v26-features-updates) | [v25 versus v26 proto diffs](https://developers.google.com/google-ads/api/docs/upgrade#proto-differences-between-v25-v26) |
| [v26.1](https://developers.google.com/google-ads/api/docs/release-notes#v26-1-2026-10-28) | October 28, 2026 | November 2027 | None (minor release) | [v26.1 features and updates](https://developers.google.com/google-ads/api/docs/release-notes#v26-1-2026-10-28) | [v25 versus v26 proto diffs](https://developers.google.com/google-ads/api/docs/upgrade#proto-differences-between-v25-v26) |
| v26.2 | November 2026 | November 2027 |   |   |   |
| v26.3\* | December 2026 | November 2027 |   |   |   |
| v27 | January 2027 | February 2028 |   |   |   |
| v27.1 | February 2027 | February 2028 |   |   |   |
| v27.2 | February 2027 | February 2028 |   |   |   |
| v27.3 | March 2027 | February 2028 |   |   |   |
| v27.4 | March 2027 | February 2028 |   |   |   |
| v28 | April 2027 | May 2028 |   |   |   |
| v28.1 | April 2027 | May 2028 |   |   |   |
| v28.2 | May 2027 | May 2028 |   |   |   |
| v28.3 | May 2027 | May 2028 |   |   |   |
| v28.4 | June 2027 | May 2028 |   |   |   |
| v28.5 | June 2027 | May 2028 |   |   |   |
| v29 | July 2027 | August 2028 |   |   |   |
| v29.1 | July 2027 | August 2028 |   |   |   |
| v29.2 | August 2027 | August 2028 |   |   |   |
| v29.3 | August 2027 | August 2028 |   |   |   |
| v29.4 | September 2027 | August 2028 |   |   |   |
| v29.5 | September 2027 | August 2028 |   |   |   |
| v30 | October 2027 | November 2028 |   |   |   |
| v30.1 | October 2027 | November 2028 |   |   |   |
| v30.2 | November 2027 | November 2028 |   |   |   |
| v30.3\* | December 2027 | November 2028 |   |   |   |

\* v26.3 and v30.3 are designated as optional releases due to overlap with the
holiday season.

## View the versions your project is using

You can view a list of methods and services your project has recently called
using the [Google Cloud Console](https://console.cloud.google.com):

1. Open the **APIs \& Services** in the Google Cloud Console.
2. Click **Google Ads API** in the table.
3. On the **METRICS** subtab, you should see your recent requests plotted on each graph. You can see which methods you've sent requests to in the **Methods** table. The method name includes a Google Ads API version, a service, and a method name, such as `google.ads.googleads.v26.services.GoogleAdsService.Mutate`.
4. (Optional) Choose the timeframe you want to view for your requests.

## Differences between deprecation and sunset

| Term | Deprecation | Sunset |
|---|---|---|
| **Definition** | The deprecated version is a version that is *not the latest one* . Once a new version is released, all previous versions will be marked **deprecated.** | The sunset version can *no longer be used*. Requests sent to this version will fail on or after the sunset date. |
| **Implication** | You can still use the deprecated versions until they're *sunset* , but the references of the deprecated versions are de-highlighted to show that they're not the latest version anymore. We encourage you to upgrade to the latest version as soon as possible to benefit from new features. | You need to upgrade from the sunset versions *immediately* in order to use the Google Ads API. We *highly recommend* that you upgrade to the *latest version* , using the [upgrade guide](https://developers.google.com/google-ads/api/docs/upgrade). |
| **Timing** | On average, we release a new version every 3 to 4 months, so the given version will be deprecated after approximately 3 to 4 months. | We aim to sunset a version 1 year after its release. |
| **API** | API endpoints for the deprecated versions *still function as usual* . You can access our API endpoints using our client libraries and REST. However, new features are not added to deprecated versions. | API endpoints for the sunset versions *stop working* after the sunset dates. The Google Ads API will throw an error if you try to access the API endpoints of the sunset versions. |
| **[Client libraries](https://developers.google.com/google-ads/api/docs/client-libs)** | For purposes of providing compact client libraries, we *will stop including* deprecated API versions in a new client library version after the deprecation date. This helps you save space when incorporating our client libraries in your projects. > [!IMPORTANT] > **Key Point:** Deprecated API versions are still available in previously released client library versions. You can still download and use them until the API versions are sunset. | Client libraries *no longer support* the sunset API versions in any new client library versions after the sunset dates. |
| **[Support](https://developers.google.com/google-ads/api/support)** | We provide regular support for the deprecated versions. | The sunset versions are *no longer supported* after the sunset date. |

## Supported client library versions

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

The listed minimum client library version is sufficient for the major Google Ads API
release (such as v26). To see the required client library version for minor
releases, refer to the linked Changelog.

### Java

[Changelog](https://github.com/googleads/google-ads-java/blob/main/CHANGELOG.md)

|---|---|
| ##### Google Ads API | ##### Client library for Java |
| `v26` | <var translate="no">Min:</var> `48.0.0` <var translate="no">Max:</var> - |
| `v25` | <var translate="no">Min:</var> `44.0.0` <var translate="no">Max:</var> - |
| `v24` | <var translate="no">Min:</var> `43.0.0` <var translate="no">Max:</var> - |
| `v23` | <var translate="no">Min:</var> `42.0.0` <var translate="no">Max:</var> - |

### C#

[Changelog](https://github.com/googleads/google-ads-dotnet/blob/main/CHANGELOG.md)

|---|---|
| ##### Google Ads API | ##### Client library for .NET |
| `v26` | <var translate="no">Min:</var> `27.5.0` <var translate="no">Max:</var> - |
| `v25` | <var translate="no">Min:</var> `26.1.0` <var translate="no">Max:</var> - |
| `v24` | <var translate="no">Min:</var> `25.3.0` <var translate="no">Max:</var> - |
| `v23` | <var translate="no">Min:</var> `25.1.0` <var translate="no">Max:</var> - |

### PHP

[Changelog](https://github.com/googleads/google-ads-php/blob/main/CHANGELOG.md)

|---|---|
| ##### Google Ads API | ##### Client library for PHP |
| `v26` | <var translate="no">Min:</var> `35.2.0` <var translate="no">Max:</var> - |
| `v25` | <var translate="no">Min:</var> `33.6.0` <var translate="no">Max:</var> - |
| `v24` | <var translate="no">Min:</var> `33.3.0` <var translate="no">Max:</var> - |
| `v23` | <var translate="no">Min:</var> `32.2.0` <var translate="no">Max:</var> - |

### Python

[Changelog](https://github.com/googleads/google-ads-python/blob/main/ChangeLog)

|---|---|
| ##### Google Ads API | ##### Client library for Python |
| `v26` | <var translate="no">Min:</var> `34.0.0` <var translate="no">Max:</var> - |
| `v25` | <var translate="no">Min:</var> `31.2.0` <var translate="no">Max:</var> - |
| `v24` | <var translate="no">Min:</var> `30.1.0` <var translate="no">Max:</var> - |
| `v23` | <var translate="no">Min:</var> `29.2.0` <var translate="no">Max:</var> - |

### Ruby

[Changelog](https://github.com/googleads/google-ads-ruby/blob/main/CHANGELOG.md)

|---|---|
| ##### Google Ads API | ##### Client library for Ruby |
| `v26` | <var translate="no">Min:</var> `46.0.0` <var translate="no">Max:</var> - |
| `v25` | <var translate="no">Min:</var> `43.0.0` <var translate="no">Max:</var> - |
| `v24` | <var translate="no">Min:</var> `40.0.0` <var translate="no">Max:</var> - |
| `v23` | <var translate="no">Min:</var> `38.0.0` <var translate="no">Max:</var> - |

### Perl

[Changelog](https://github.com/googleads/google-ads-perl/blob/main/CHANGELOG.md)

|---|---|
| ##### Google Ads API | ##### Client library for Perl |
| `v26` | <var translate="no">Min:</var> `36.0.0` <var translate="no">Max:</var> - |
| `v25` | <var translate="no">Min:</var> `33.0.0` <var translate="no">Max:</var> - |
| `v24` | <var translate="no">Min:</var> `32.0.0` <var translate="no">Max:</var> - |
| `v23` | <var translate="no">Min:</var> `31.0.0` <var translate="no">Max:</var> - |

## Feature deprecations and changes

While this page focuses on API version-level lifecycles, individual feature
deprecations (such as the deprecation of Smart Campaigns) and unversioned
workflow changes (such as new Demand Gen campaign budget requirements) are
tracked separately.

To check upcoming feature lifecycles and behavioral shifts across active
versions, see the
[Feature deprecations and unversioned changes](https://developers.google.com/google-ads/api/docs/deprecations) guide.