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 tables below for specific areas to focus on for the version you're upgrading to.
For a comprehensive overview of changes based on a diff between the protos from the two versions, look at the diff table.
v16 to v17
Changes to services and their components | |
---|---|
GoogleAdsService
Search and SearchStream requests |
The error when your request is throttled because it is too expensive will
be either
|
GoogleAdsService
Search requests. |
Passing a |
Campaign and Ad |
Campaigns with an Additionally, some ads will change type and field names for reporting:
|
AdService |
The GetAd endpoint will be removed. This brings the
AdService in line with other services in the Google Ads API. See our
guide on retrieving
objects for the recommended way to fetch ads and other resource types. |
CustomerLifecycleGoal
and CampaignLifecycleGoal |
The way you manage segments for lifecycles goals is reworked. See the segment your audiences section of the lifecycle goals documentation for a complete overview. |
ProductLink |
When running a GoogleAdsService search or search stream
request for product_link , you can now only select fields related
to one linked product. Selecting multiple fields from different linked products
will result in a
QuotaError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE
error. |
Reporting | Renamed the metrics.sk_ad_network_conversion_value field to
metrics.sk_ad_network_fine_conversion_value . |