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.
Check out our deprecation schedule to plan your upgrades. See our versioning guide to learn how versioning works.
Here's a checklist to help you get started with the process of upgrading:
- Your endpoint will change when you change major versions. Update your client libraries to use the newest endpoint.
- Go through the release notes to see changes that were introduced in each release.
- Check out the release notes, for specific areas to focus on for the version to which you are upgrading.
- Check out the proto difference tables, like Proto differences between v23 and v24.
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 tv24.1 release notes.
v23.2 to v24
See the v24 release notes.
v23
This section describes all of the changes in the major version v23 and the minor versions v23.1 and v23.2.
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.
You can view quick and full-context diffs in the Changed tab.
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.
v22
This section describes all of the changes in the major version v22 and the minor version v22.1.
Proto differences between v21 and v22
This table shows the protos that were added, removed, and changed in the Google Ads API v22 release, as compared to the latest v21 release. You can click the links to view the protos in our GitHub repository after they're released.
You can view quick and full-context diffs in the Changed tab.
v22 to v22.1
See the v22.1 release notes.
v21 to v22
See the v22 release notes.
v21
This section describes all of the changes in the major version v21 and the minor version v21.1.
Proto differences between v20 and v21
This table shows the protos that were added, removed, and changed in the Google Ads API v21 release, as compared to the latest v20 release. You can click the links to view the protos in our GitHub repository after they're released.
You can view quick and full-context diffs in the Changed tab.
v21 to v21.1
See the v21.1 release notes.
v20 to v21
See the v21 release notes.