Join us live on Discord on the Google Advertising and Measurement Community server and on YouTube on October 15th at 10:00 AM EST! We will discuss the new features added in v26 of the Google Ads API.

Upgrade your API version

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 v25 and v26.

v26

This section describes all of the changes in the major version v26.

Proto differences between v25 and v26

This table shows the protos that were added, removed, and changed in the Google Ads API v26 release, as compared to the latest v25.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.

Added (7)

v26/enums/date_selection_type.proto

v26/enums/enhanced_conversions_config.proto

v26/enums/search_lift_keyword_bundle_status.proto

v26/enums/search_lift_matching_info_source.proto

v26/enums/search_lift_search_property.proto

v26/enums/youtube_video_upload_generative_content_disclosure.proto

v26/resources/search_lift_keyword_bundle.proto

Removed (0)

Changed (31)

v25.2 to v26

See the v26 release notes.

v25

This section describes all of the changes in the major version v25 and the minor versions v25.1 and v25.2.

Proto differences between v24 and v25

This table shows the protos that were added, removed, and changed in the Google Ads API v25 and v25.1 releases, as compared to the latest v24.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.

Added (26)

v25/common/effective_automatic_goal.proto

v25/enums/ad_sub_format_type.proto

v25/enums/benchmarks_customer_percentile_tier.proto

v25/enums/benchmarks_supplemental_data.proto

v25/enums/brand_lift_measurement_type.proto

v25/enums/conversion_lift_included_conversion_action_types.proto

v25/enums/customer_lifecycle_optimization_goal_sub_type.proto

v25/enums/incentive_offer_type.proto

v25/enums/incentive_type.proto

v25/enums/lift_measurement_flight_status.proto

v25/enums/lift_metric_type.proto

v25/enums/loyalty_membership.proto

v25/enums/sentiment.proto

v25/enums/survey_intended_action.proto

v25/enums/survey_lift_flight_target_response_mode.proto

v25/enums/survey_subject_type.proto

v25/enums/third_party_conversion_attribution_integration_partner.proto

v25/enums/video_crawl_source_platform.proto

v25/errors/business_profile_location_sync_error.proto

v25/resources/lift_measurement_age_range.proto

v25/resources/lift_measurement_campaign.proto

v25/resources/lift_measurement_config.proto

v25/resources/lift_measurement_device.proto

v25/resources/lift_measurement_flight.proto

v25/resources/lift_measurement_gender.proto

v25/resources/lift_measurement_video.proto

Removed (8)

v24/common/lifecycle_goals.proto

v24/enums/customer_acquisition_optimization_mode.proto

v24/errors/campaign_lifecycle_goal_error.proto

v24/errors/customer_lifecycle_goal_error.proto

v24/resources/campaign_lifecycle_goal.proto

v24/resources/customer_lifecycle_goal.proto

v24/services/campaign_lifecycle_goal_service.proto

v24/services/customer_lifecycle_goal_service.proto

Changed (43)

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.

Added (12)

v24/actions/generate_shareable_previews.proto

v24/common/experiment_types.proto

v24/enums/content_creator_insights_supplemental_data.proto

v24/enums/experiment_asset_detail_operation.proto

v24/enums/gls_phone_number_type.proto

v24/enums/mobile_device_platform.proto

v24/enums/optimize_assets_experiment_subtype.proto

v24/enums/reach_plan_buying_method.proto

v24/enums/reach_plan_cost_model.proto

v24/enums/reach_plan_marketing_objective.proto

v24/enums/video_experiment_subtype.proto

v24/resources/cart_data_sales_view.proto

Removed (0)

Changed (45)

v24.1 to v24.2

See the v24.2 release notes.

v24 to v24.1

See the v24.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. Note that v22 has been sunset.

You can view quick and full-context diffs in the Changed tab.

Added (34)

v23/actions/book_campaigns.proto

v23/actions/quote_campaigns.proto

v23/common/campaign_reservation_quote.proto

v23/enums/ad_sub_network_type.proto

v23/enums/asset_orientation.proto

v23/enums/benchmarks_marketing_objective.proto

v23/enums/benchmarks_source_type.proto

v23/enums/benchmarks_time_granularity.proto

v23/enums/booking_status.proto

v23/enums/incentive_state.proto

v23/enums/messaging_restriction_type.proto

v23/enums/partnership_opportunity.proto

v23/enums/preview_type.proto

v23/enums/regulatory_fee_type.proto

v23/enums/reservation_request_type.proto

v23/enums/unit_of_measure.proto

v23/enums/vertical_ads_item_vertical_type.proto

v23/enums/video_enhancement_source.proto

v23/enums/youtube_video_privacy.proto

v23/enums/youtube_video_upload_state.proto

v23/errors/action_error.proto

v23/errors/benchmarks_error.proto

v23/errors/content_creator_insights_error.proto

v23/errors/incentive_error.proto

v23/errors/video_reservation_error.proto

v23/resources/applied_incentive.proto

v23/resources/app_top_combination_view.proto

v23/resources/matched_location_interest_view.proto

v23/resources/video_enhancement.proto

v23/resources/youtube_video_upload.proto

v23/services/benchmarks_service.proto

v23/services/incentive_service.proto

v23/services/reservation_service.proto

v23/services/youtube_video_upload_service.proto

Removed (0)

Changed (56)

v22	v23	Diffs
/common/ad_asset.proto	/common/ad_asset.proto	Quick \| Full
/common/ad_type_infos.proto	/common/ad_type_infos.proto	Quick \| Full
/common/asset_types.proto	/common/asset_types.proto	Quick \| Full
/common/audience_insights_attribute.proto	/common/audience_insights_attribute.proto	Quick \| Full
/common/criteria.proto	/common/criteria.proto	Quick \| Full
/common/metrics.proto	/common/metrics.proto	Quick \| Full
/common/segments.proto	/common/segments.proto	Quick \| Full
/enums/ad_format_type.proto	/enums/ad_format_type.proto	Quick \| Full
/enums/asset_field_type.proto	/enums/asset_field_type.proto	Quick \| Full
/enums/asset_performance_label.proto	/enums/asset_performance_label.proto	Quick \| Full
/enums/audience_insights_dimension.proto	/enums/audience_insights_dimension.proto	Quick \| Full
/enums/audience_insights_marketing_objective.proto	/enums/audience_insights_marketing_objective.proto	Quick \| Full
/enums/business_message_provider.proto	/enums/business_message_provider.proto	Quick \| Full
/enums/campaign_primary_status_reason.proto	/enums/campaign_primary_status_reason.proto	Quick \| Full
/enums/conversion_action_category.proto	/enums/conversion_action_category.proto	Quick \| Full
/enums/criterion_type.proto	/enums/criterion_type.proto	Quick \| Full
/enums/reach_plan_age_range.proto	/enums/reach_plan_age_range.proto	Quick \| Full
/enums/reach_plan_surface.proto	/enums/reach_plan_surface.proto	Quick \| Full
/enums/search_term_match_source.proto	/enums/search_term_match_source.proto	Quick \| Full
/enums/served_asset_field_type.proto	/enums/served_asset_field_type.proto	Quick \| Full
/enums/shared_set_type.proto	/enums/shared_set_type.proto	Quick \| Full
/errors/ad_group_ad_error.proto	/errors/ad_group_ad_error.proto	Quick \| Full
/errors/ad_group_error.proto	/errors/ad_group_error.proto	Quick \| Full
/errors/asset_error.proto	/errors/asset_error.proto	Quick \| Full
/errors/authentication_error.proto	/errors/authentication_error.proto	Quick \| Full
/errors/campaign_criterion_error.proto	/errors/campaign_criterion_error.proto	Quick \| Full
/errors/campaign_error.proto	/errors/campaign_error.proto	Quick \| Full
/errors/criterion_error.proto	/errors/criterion_error.proto	Quick \| Full
/errors/customer_client_link_error.proto	/errors/customer_client_link_error.proto	Quick \| Full
/errors/date_error.proto	/errors/date_error.proto	Quick \| Full
/errors/errors.proto	/errors/errors.proto	Quick \| Full
/errors/product_link_invitation_error.proto	/errors/product_link_invitation_error.proto	Quick \| Full
/errors/query_error.proto	/errors/query_error.proto	Quick \| Full
/errors/request_error.proto	/errors/request_error.proto	Quick \| Full
/errors/shareable_preview_error.proto	/errors/shareable_preview_error.proto	Quick \| Full
/googleads_grpc_service_config.proto	/googleads_grpc_service_config.proto	Quick \| Full
/resources/ad_group_ad.proto	/resources/ad_group_ad.proto	Quick \| Full
/resources/ad_group_criterion.proto	/resources/ad_group_criterion.proto	Quick \| Full
/resources/ad_group.proto	/resources/ad_group.proto	Quick \| Full
/resources/asset.proto	/resources/asset.proto	Quick \| Full
/resources/campaign.proto	/resources/campaign.proto	Quick \| Full
/resources/customer.proto	/resources/customer.proto	Quick \| Full
/resources/invoice.proto	/resources/invoice.proto	Quick \| Full
/resources/per_store_view.proto	/resources/per_store_view.proto	Quick \| Full
/resources/product_link_invitation.proto	/resources/product_link_invitation.proto	Quick \| Full
/resources/product_link.proto	/resources/product_link.proto	Quick \| Full
/resources/shared_criterion.proto	/resources/shared_criterion.proto	Quick \| Full
/resources/shared_set.proto	/resources/shared_set.proto	Quick \| Full
/resources/shopping_product.proto	/resources/shopping_product.proto	Quick \| Full
/services/audience_insights_service.proto	/services/audience_insights_service.proto	Quick \| Full
/services/content_creator_insights_service.proto	/services/content_creator_insights_service.proto	Quick \| Full
/services/google_ads_service.proto	/services/google_ads_service.proto	Quick \| Full
/services/invoice_service.proto	/services/invoice_service.proto	Quick \| Full
/services/reach_plan_service.proto	/services/reach_plan_service.proto	Quick \| Full
/services/recommendation_service.proto	/services/recommendation_service.proto	Quick \| Full
/services/shareable_preview_service.proto	/services/shareable_preview_service.proto	Quick \| Full

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.

Upgrade your API version Stay organized with collections Save and categorize content based on your preferences.

v26

Proto differences between v25 and v26

v25.2 to v26

v25

Proto differences between v24 and v25

v25.1 to v25.2

v25 to v25.1

v24.2 to v25

v24

Proto differences between v23 and v24

v24.1 to v24.2

v24 to v24.1

v23.2 to v24

v23

Proto differences between v22 and v23

v23.1 to v23.2

v23 to v23.1

v22 to v23

Upgrade your API version