Periodically, you will upgrade from an older major version of 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 upgrade to the newest version when going through the migration process.
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.
Migrating from v9 to v10
For a comprehensive overview of changes based on a diff between the protos from the two versions, look at the diff table.
Changes to Services and their Components | |
---|---|
All services | get methods have been removed. Any service that exclusively
had a get method has been removed as well. The primary way to retrieve objects continues to be
using GoogleAdsService 's search and
searchStream methods. |
GoogleAdsService
search methods |
Fixed an issue where zero-metric rows were sometimes being returned when adding segment fields. This brings all reports in line with expected behavior. |
Campaign |
The start_date and end_date fields in the
Campaign now return values in the context of that campaign's
account's time zone. This resolves some discrepancies where the start and end
dates seemed not to match when compared to the Google Ads UI. |
CampaignExperiment |
The new We have a migration guide to assist with adopting the new services. |
CustomerClient |
Added Non-active and test accounts are now returned by More specifically, prior to v10, In v10, |
Asset |
The |
Asset |
When an |
VideoTrueViewDiscoveryAdInfo |
The VideoTrueViewDiscoveryAdInfo ad type has been renamed to
InFeedVideoAdInfo . |
ConversionActionCategory |
The LEAD type has been removed from
ConversionActionCategory . |
GoogleAdsService.MutateOperation |
The customizer_customizer_operation has been renamed to
customer_customizer_operation , fixing a typo. |
BiddingSeasonalityAdjustment |
BiddingSeasonalityAdjustment can no longer be set at the
manager account level. Doing so was always an error; this just enforces that
they can no longer be created accidentally. |