Release notes

  • Google Ads API v22 introduces the AssetGenerationService for generating text and image assets using generative AI.

  • New bidding goals without a target CPA or ROAS are added for App campaigns to optimize for installs or total value.

  • Demand Gen campaigns now support the TargetCPC bidding strategy and asset automation for generating design variations and videos from existing assets.

  • Performance Max campaigns gain new AssetAutomationType values for image enhancement and extraction, along with new segments for reporting.

  • Planning services include updates for user lists, partner audiences, YouTube metrics, trend insights, and support for parental status and income ranges in AudienceInsightsService.

Refer to Feature deprecations for an up to date list of current and planned feature deprecations.

v25 major and minor versions

Google Ads API v25 includes the following new features, updates, and breaking changes.

v25.1 (2026-08-19)

The following new features and updates were added in Google Ads API v25.1. Minor versions like v25.1 don't contain breaking changes.

Features and updates Type Description
Assets
AssetFieldType.TEXT_DISCLAIMER
ServedAssetFieldType.TEXT_DISCLAIMER		 New enum values Added support for text disclaimer assets.
Campaigns
Campaign.aca_migration_date_time
Campaign.broad_match_migration_date_time		 New fields Track the upcoming auto-migration to AI Max.
Conversions
Brand Lift measurements New features Added support for Brand Lift measurements with the following updates:
Conversion Lift measurements New features Added support for Conversion Lift measurements with the following updates:
LiftMeasurementFlight New resource A new read-only resource representing flight details for a lift measurement configuration, including measured flight start and end dates (start_date and end_date).
General
SmartCampaignError New enum values Added new specific error codes for Performance Max generation constraints:
AuthorizationErrorEnum.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION New enum value / error Returned when a Google Cloud project with TEST access level attempts to make requests against a non-test account.
Planning
Brand sentiment insights New features Added support for brand sentiment insights in ContentCreatorInsightsService:
BenchmarksService enhancements New features Added support for categories as filters for scoping a benchmarks analysis. Also supported additional business critical metrics:
Parental status targeting New feature Added support for parental status targeting in reach planning. The new field parental_statuses has been added to Targeting for service ReachPlanService.GenerateReachForecast, and parental_statuses has been added to PlannableTargeting for service ReachPlanService.ListPlannableProducts.
Recommendations
Recommendation.campaign_specific_app_goal_recommendation New recommendation Suggests adding a campaign-specific app conversion goal. The new EffectiveAutomaticGoal resource is used to represent current goals within this recommendation.
Reports
Metrics.original_conversion_value New field Represents the original conversion value from biddable conversions. This is the unadjusted value of conversions before any value rule adjustments, such as conversion value rules or lifecycle goals adjustments are applied.
Loyalty membership stats New features Added support for segmenting stats by user loyalty membership program status, and added loyalty membership primary dimension for conversion value rules:
  • Added the Segments.loyalty_membership segment to support segmenting report metrics by the loyalty program tier of the converting user.
  • Added the LOYALTY_MEMBERSHIP primary dimension to identify when a loyalty membership condition was satisfied for a conversion value rule.
Targeting
vertical_ads_item_bid New criterion type Added the new vertical_ads_item_bid criterion type to AdGroupCriterion.criterion.

v25 (2026-07-22)

The following new features, updates, and breaking changes were added in Google Ads API v25, which is a major release.

See Upgrade to the latest version for guidance.

Breaking changes

Initial state New state Change type Implementation guidance
Campaigns
Standalone fields additional_value and additional_high_lifetime_value in CustomerLifecycleOptimizationValueSettings Part of value_adjustment and high_lifetime_value_adjustment oneofs respectively, alongside the new value_multiplier and high_lifetime_value_multiplier fields Structural change Update references to these fields as they are now part of oneofs.
Legacy CustomerLifecycleGoal and CampaignLifecycleGoal resources, their corresponding services CustomerLifecycleGoalService and CampaignLifecycleGoalService, and legacy settings/enums (CustomerAcquisitionGoalSettings, CustomerAcquisitionOptimizationModeEnum, LifecycleGoalValueSettings) None Removal Use the revamped unified goals schema:
General
Nested enum fields in Incentive Service request and response messages:
  • FetchIncentiveRequest.type
  • Incentive.type
  • IncentiveOffer.type
 Standalone enum fields: Rename / removal Use the new standalone enum fields instead of the legacy type fields.
Optional selected_incentive_id and customer_id fields in ApplyIncentiveRequest Required fields Behavioral shift Ensure you provide both fields when calling ApplyIncentive.
The consumer email address field ContactDetails.email in the LocalServicesLead resource None Removal Remove references to this field because it is no longer supported.
Optional allowed_domain field in AdvertisingPartnerLinkInvitationProperties Required field when calling CreateProductLinkInvitation for an advertising partner Behavioral shift Ensure you provide allowed_domain when creating a product link invitation for an advertising partner.
Planning
The search_brand field in GenerateCreatorInsightsRequest None Removal Use search_topics instead.
The plannable_location_id field in Targeting and cookie_frequency_cap field in GenerateReachForecastRequest None Removal Switch to using plannable_location_ids and cookie_frequency_cap_setting.
Reports
customer_metrics field in GenerateBenchmarksMetricsResponse and BreakdownMetrics of type Metrics Field of type CustomerMetrics Type change / behavioral shift Update your integrations to use the new CustomerMetrics type, which only contains metrics representing the customer's ad performance.

Features and updates (non-breaking)

Features and updates Type Description
Ads
AssetAutomationType.GENERATE_ANIMATED_IMAGES_FROM_OTHER_ASSETS New enum value / behavior Available for DemandGenMultiAssetAds. If enabled, it generates animated images using non-animated images as input. New DemandGenMultiAssetAds are opted in by default starting with this API version.
Synthetic content info mutability Behavior change Asset.synthetic_content_info and Ad.synthetic_content_info are now fully mutable in v25, v24, and v23.
Campaigns
Loyalty Retention Goal New features / settings Added support for Loyalty Retention Goal, which allows advertisers to optimize campaigns for retaining loyalty program members.