Page Summary
-
Periodically upgrading to the newest major version of the Google Ads API is recommended, especially if a version is sunsetting or to use new features.
-
To get started with an upgrade, update your client libraries to use the newest endpoint, review release notes for changes, and check tables for version-specific focus areas.
-
The provided content includes specific changes for upgrading from v21 to v22, v20 to v21, v19 to v20, and v18 to v19, detailing renamed fields, new limits, removed elements, and service/component changes.
-
Upgrading from v18 to v19 is specifically highlighted as v18 is sunset, requiring immediate action.
Periodically, you might want to upgrade from an older major version of the Google Ads API to a newer major version. It could be because a version is sunsetting, or it could be because you want to use a new feature. We recommend that you always upgrade to the newest version.
Review the deprecation and sunset schedule to plan your upgrades and the versioning guide to learn how versioning works.
Follow this checklist when upgrading to a new major version:
- Update your client library and endpoint: Your endpoint changes when you upgrade to a new major version. Update your client libraries to a version that supports the target API release.
- Audit breaking changes and feature deprecations: Review the breaking changes in the release notes for every major version between your current version and your target version, and check feature deprecations for upcoming behavioral shifts.
- Adopt new features and updates: Check the features and updates in the release notes to identify new services, fields, and enum values introduced in each release.
- Filter the proto difference tables: Use the filterable proto difference tables on this page, such as Proto differences between v25 and v26, to search for specific services, resources, enums, or errors and open their side-by-side Quick or Full diffs.
Version upgrade quick reference
Use the following table to jump directly to the breaking changes, feature updates, proto difference tables, and sunset schedule for each active major version:
| Target version | Breaking changes | New features and minor releases | Proto difference table | Schedule |
|---|---|---|---|---|
| v26 (Latest) | v26 breaking changes | v26 features and updates | v25 versus v26 proto diffs | Release and sunset dates |
| v25 | v25 breaking changes | v25, v25.1, v25.2 | v24 versus v25 proto diffs | Release and sunset dates |
| v24 | v24 breaking changes | v24, v24.1, v24.2 | v23 versus v24 proto diffs | Release and sunset dates |
| v23 | v23 breaking changes | v23, v23.1, v23.2, v23.3 | v22 versus v23 proto diffs | Release and sunset dates |
v26
This section describes all of the changes in the major version v26.
Proto differences between v25 and v26
This table shows the protos that were added, removed, and changed in the Google Ads API v26 release, as compared to the latest v25.2 release. You can click the links to view the protos in our GitHub repository.
You can view quick and full-context diffs in the Changed tab.
v25.2 to v26
See the v26 release notes (breaking changes | features and updates).
v25
This section describes all of the changes in the major version v25 and the minor versions v25.1 and v25.2.
Proto differences between v24 and v25
This table shows the protos that were added, removed, and changed in the Google Ads API v25 and v25.1 releases, as compared to the latest v24.2 release. You can click the links to view the protos in our GitHub repository.
You can view quick and full-context diffs in the Changed tab.
v25.1 to v25.2
See the v25.2 release notes.
v25 to v25.1
See the v25.1 release notes.
v24.2 to v25
See the v25 release notes (breaking changes | features and updates).
v24
This section describes all of the changes in the major version v24 and the minor versions v24.1 and v24.2.
Proto differences between v23 and v24
This table shows the protos that were added, removed, and changed in the Google Ads API v24 and v24.1 releases, as compared to the latest v23.2 release. You can click the links to view the protos in our GitHub repository.
You can view quick and full-context diffs in the Changed tab.
v24.1 to v24.2
See the v24.2 release notes.
v24 to v24.1
See the v24.1 release notes.
v23.2 to v24
See the v24 release notes (breaking changes | features and updates).
v23
This section describes all of the changes in the major version v23 and the minor versions v23.1, v23.2, and v23.3.
Proto differences between v22 and v23
This table shows the protos that were added, removed, and changed in the Google Ads API v23 release, as compared to the latest v22 release. You can click the links to view the protos in our GitHub repository. Note that v22 has been sunset.
You can view quick and full-context diffs in the Changed tab.
v23.2 to v23.3
See the v23.3 release notes.
v23.1 to v23.2
See the v23.2 release notes.
v23 to v23.1
See the v23.1 release notes.
v22 to v23
See the v23 release notes (breaking changes | features and updates).