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:

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 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: The `customer_id` of an `UploadClickConversionsRequest` or an `UploadCallConversionsRequest` must be the customer ID of the `owner_customer` of each `conversion_action` targeted in the request. The `customer_id` of an `UploadClickConversionsRequest` or an `UploadCallConversionsRequest` must be the customer ID of the effective conversion tracking account of the Google Ads account of the click or call. Otherwise, the conversion upload will result in a `ConversionUploadError` of `INVALID_CUSTOMER_FOR_CLICK` or `INVALID_CUSTOMER_FOR_CALL`.
`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`.