Upgrading to the newest version

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:

  1. Your endpoint will change when you change major versions. Update your client libraries to use the newest endpoint.
  2. Go through the release notes to see changes that were introduced in each release.
  3. Check out the tables below for specific areas to focus on for the version you're upgrading to.

Migrating from v7 to v8

Changes to Services and their Components
CallOnlyAdInfo The CallOnlyAdInfo has been replaced with CallAdInfo.
LeadFormFieldUserInputType

LeadFormFieldUserInputType.GIVEN_NAME has been replaced with LeadFormFieldUserInputType.FIRST_NAME.

LeadFormFieldUserInputType.FAMILY_NAME has been replaced with LeadFormFieldUserInputType.LAST_NAME.

CampaignError CampaignError.PAYMENT_MODE_NOT_COMPATIBLE_WITH_VIEW_THROUGH_CONVERSION has been replaced with CampaignError.NOT_COMPATIBLE_WITH_VIEW_THROUGH_CONVERSION_OPTIMIZATION.
ConversionUploadService The following additional requirements were added for both click and call conversion uploads:
UploadCallConversions A call conversion upload where the conversion source did not comply with the App Tracking Transparency (ATT) policy or the person who converted didn't consent to tracking will fail with a ConversionUploadError of CONVERSION_NOT_COMPLIANT_WITH_ATT_POLICY instead of UNKNOWN.