Google Ads API Updates & Release Notes
20 updates curated from 1 source by the Releasebot Team. Last updated: Jun 25, 2026
- Jun 24, 2026
- Date parsed from source:Jun 24, 2026
- First seen by Releasebot:Jun 25, 2026
- Modified by Releasebot:Jul 8, 2026
v24.2 (2026-06-24)
Google Ads API v24.2 adds new Performance Max, Demand Gen, conversion, experiment, and synthetic content capabilities, plus Multi-Party Authorization review support. It also expands Local Services Ads handling and introduces several new fields and error checks.
The following new features and updates were added in Google Ads API v24.2. Minor versions like v24.2 don't contain breaking changes.
Ads
- AssetAutomationType.GENERATE_LANDING_PAGE_TEXT: New enum value. Generates text information from the landing page to be shown in the engagement panel for DemandGenVideoResponsiveAd instances (which are opted in by default starting with this API version).
Assets
- AssetGroup.google_local_services_info: New field. Added to support Local Services Ads information (category ID and callouts) in Performance Max campaigns.
- AssetGroupSignal.local_services_id: New field. Added to support Local Services Ads service ID signals in Performance Max campaigns.
- AssetGroupSignal.vertical_ads_item_group_rule_list: New field. Added to support vertical ads item group rules for selecting items from attached vertical feeds in Performance Max campaigns. This feature is only available to accounts on the allowlist.
Errors
- AssetGroupErrorEnum.CANNOT_REMOVE_ALL_ASSET_GROUPS_FROM_CAMPAIGN: New enum value / error. Returned when attempting to remove all asset groups from a campaign.
- AssetGroupSignalErrorEnum.CANNOT_REMOVE_ALL_SIGNALS: New enum value / error. Returned when attempting to remove all signals from an asset group.
Campaigns
- Campaign.PmaxCampaignSettings.local_services_pmax_campaign_settings and Campaign.PmaxCampaignSettings.local_services_enabled: New fields. Support identifying Local Services Performance Max campaigns.
AdGroup
- AdGroup.DemandGenAdGroupSettings.DemandGenChannelControls.DemandGenSelectedChannels.maps: New field. Includes Google Maps in the selectable channels for Demand Gen ad groups.
Errors
- CampaignCriterionErrorEnum.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN: New enum value / error. Returned when attempting to remove all locations from a local services Performance Max campaign.
- SmartCampaignErrorEnum.CREATION_FAILED: New enum value / error. Returned when attempting to create new Smart Campaigns.
Conversions
- ConversionOrigin.LOCAL_SERVICES_ADS and ConversionActionType.LOCAL_SERVICES_ADS: New enum values. Represent conversions that occur when a user clicks on a local services ad and calls, messages, or books the advertiser.
Experiments
- COMPARE_CAMPAIGNS, PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION: New enum values. Added support for new ExperimentType types: COMPARE_CAMPAIGNS: For campaign mix experiments and custom Performance Max experiments that compare multiple campaigns of the same or different types in a single experiment. PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION: For Performance Max optimization experiments for text customization and Final URL expansion.
General
- Asset.synthetic_content_info and Ad.synthetic_content_info: New fields. Contain attestations for synthetic/AI-generated content, split into advertiser_attestation (declarations provided directly by the advertiser) and system_attestation (attestations automatically detected or provided by the system). This feature has been backported to v23 and v22. To help you plan your upcoming integration work for v25, the interface for mutating advertiser attestation fields is being introduced early for v22 and higher. The interface is visible in these versions, but synthetic_content_info.advertiser_attestation.status and synthetic_content_info.advertiser_attestation.source will remain immutable for these versions. If you attempt a mutate request on either of these fields, one of these errors will be returned: "The field attempted to be mutated is immutable" or "Field cannot be set". These fields will become fully mutable starting in v25. We recommend using the interface now to build and test your internal logic so your system is ready for full write capabilities when v25 is launched.
Multi-Party Authorization
- Added support for Multi-Party Authorization (MPA) reviews: Added the MultiPartyAuthReview resource and corresponding MultiPartyAuthReviewService. Added the MultiPartyAuthReviewStatus enum to track the review status. Added CustomerUserAccess.pending_multi_party_auth_review to link to a pending review. Added MutateCustomerUserAccessResult.multi_party_auth_review and MutateCustomerUserAccessInvitationResult.multi_party_auth_review to return the associated review resource name. Added MultiPartyAuthReviewError for validation errors. This feature has been backported to v23.3, v22.2, and v21.2.
- Beta: This feature is currently in beta and is subject to change in future releases.
- Jun 24, 2026
- Date parsed from source:Jun 24, 2026
- First seen by Releasebot:Jun 25, 2026
- Modified by Releasebot:Jul 8, 2026
v23.3 (2026-06-24)
Google Ads API adds v23.3 updates for synthetic content attestations and beta multi-party approvals. It introduces new fields for AI-generated content tracking plus new review resources, status tracking, and access links to support MPA workflows.
The following new features and updates were added in Google Ads API v23.3. Minor versions like v23.3 don't contain breaking changes.
General
- Asset.synthetic_content_info and Ad.synthetic_content_info: New fields. Contain attestations for synthetic/AI-generated content, split into advertiser_attestation (declarations provided directly by the advertiser) and system_attestation (attestations automatically detected or provided by Google's systems). To help you plan your upcoming integration work for v25, the interface for mutating advertiser attestation fields is being introduced early for v22 and higher. The interface is visible in these versions, but synthetic_content_info.advertiser_attestation.status and synthetic_content_info.advertiser_attestation.source will remain immutable for these versions. If you attempt a mutate request on either of these fields, one of these errors will be returned: "The field attempted to be mutated is immutable" or "Field cannot be set". These fields will become fully mutable starting in v25. We recommend using the interface now to build and test your internal logic so your system is ready for full write capabilities when v25 is launched.
Multi-party approvals
- Added support for multi-party approvals (MPA) reviews: Added the MultiPartyAuthReview resource and corresponding MultiPartyAuthReviewService. Added the MultiPartyAuthReviewStatus enum to track the review status. Added CustomerUserAccess.pending_multi_party_auth_review to link to a pending review. Added MutateCustomerUserAccessResult.multi_party_auth_review and MutateCustomerUserAccessInvitationResult.multi_party_auth_review to return the associated review resource name. Added MultiPartyAuthReviewError for validation errors.
- Beta: This feature is currently in beta and is subject to change in future releases.
All of your release notes in one feed
Join Releasebot and get updates from Google and hundreds of other software products.
- Jun 24, 2026
- Date parsed from source:Jun 24, 2026
- First seen by Releasebot:Jun 25, 2026
- Modified by Releasebot:Jul 14, 2026
v23.3 (2026-06-24)
Google Ads API adds v23.3 updates with new synthetic content info fields for assets and ads, plus support for multi-party approvals reviews through new resources, services, status enums, and error handling. The release is in beta and notes no breaking changes.
The following new features and updates were added in Google Ads API v23.3. Minor versions like v23.3 don't contain breaking changes.
General
- Asset.synthetic_content_info and Ad.synthetic_content_info: New fields. Contain attestations for synthetic/AI-generated content, split into advertiser_attestation and system_attestation. Interface for mutating advertiser attestation fields introduced early for v22 and higher; fields remain immutable until v25.
Multi-party approvals
- Added support for multi-party approvals (MPA) reviews including MultiPartyAuthReview resource, service, status enum, and error handling. This feature is currently in beta and subject to change.
- Jun 24, 2026
- Date parsed from source:Jun 24, 2026
- First seen by Releasebot:Jun 25, 2026
- Modified by Releasebot:Jul 14, 2026
v21.2 (2026-06-24)
Google Ads API adds beta support for multi-party approvals reviews in v21.2.
The following new features and updates were added in Google Ads API v21.2. Minor versions like v21.2 don't contain breaking changes.
- General: Added support for multi-party approvals (MPA) reviews including MultiPartyAuthReview resource, service, status enum, and error handling. This feature is currently in beta and is subject to change in future releases.
- May 13, 2026
- Date parsed from source:May 13, 2026
- First seen by Releasebot:May 14, 2026
- Modified by Releasebot:Jul 14, 2026
v24.1 (2026-05-13)
Google Ads API adds v24.1 updates with new ad, experiment, reporting, and video fields, plus support for additional experiment types and mobile device platform segmentation. It also improves customer access visibility and adds a new language targeting error for clearer campaign setup.
The following new features and updates were added in Google Ads API v24.1.
Minor versions like v24.1 don't contain breaking changes.
- Ads: DemandGenMultiAssetAdInfo.classic_display_images: New field. Custom uploaded display images served without requiring extra responsive assets.
- Experiments: Added support for new ExperimentType types: ADOPT_AI_MAX, ADOPT_BROAD_MATCH_KEYWORDS, OPTIMIZE_ASSETS, PMAX_REPLACEMENT_SHOPPING.
- Experiment.video_experiment: New field. Configuration support for existing YOUTUBE_CUSTOM experiments consisting of Video campaigns.
- ExperimentArm.asset_testing_info, ExperimentArm.asset_groups, ExperimentArm.performance_max_experiment_arm_info: New fields. Exposes fields to support asset testing, asset groups, and Performance Max settings in experiment arms.
- General: CustomerUserAccess.passkey_enabled: New field. Read-only field indicating whether the user has a passkey enabled.
- Reports: mobile_device_platform: New segment. Allows segmenting reports by the user device's platform (such as iOS or Android).
- CriterionErrorEnum.CANNOT_TARGET_LANGUAGE: New enum value / error. Returned when attempting to target a language that is not allowed.
- Videos: DataLink.youtube_link_metadata: New field. Contains brand_channel_id to specify the ID of the linked YouTube brand channel.
Similar to Google Ads API with recent updates:
- Google Ads updates76 release notes · Latest Jul 13, 2026
- Gemini updates354 release notes · Latest Jul 16, 2026
- Claude updates116 release notes · Latest Jul 14, 2026
- Google Analytics updates8 release notes · Latest Jun 11, 2026
- Gemini API updates131 release notes · Latest Jul 6, 2026
- Google Workspace updates51 release notes · Latest Jul 17, 2026
- Apr 22, 2026
- Date parsed from source:Apr 22, 2026
- First seen by Releasebot:Apr 22, 2026
- Modified by Releasebot:Jul 14, 2026
v24 (2026-04-22)
Google Ads API releases v24 with major updates, breaking changes, and new capabilities across ads, campaigns, conversions, planning, reporting, shopping, and video tools, including mutable responsive video ads, VTC optimization, and richer asset and reporting data.
The following new features, updates, and breaking changes were added in Google Ads API v24, which is a major release.
See Upgrade to the latest version for guidance.
Breaking changes
- Ads: Optional videos and logo_images in DemandGenVideoResponsiveAdInfo are now required fields. Provide videos and logo_images when creating or mutating responsive Demand Gen video ads.
- Optional videos, business_name, and logo_images in VideoResponsiveAdInfo are now required fields. Provide videos, business_name, and logo_images when creating or mutating video responsive ads. Note that VideoResponsiveAdInfo is now mutable.
- Campaigns: Campaign.video_brand_safety_suitability removed. Use Customer.video_brand_safety_suitability instead.
- Conversions: The loyalty sign ups user category has been removed. Remove code references to it.
- Planning: Typed client libraries integrations must be updated to use the new resource namespaces.
- Removed ad_sub_network_type segment for the campaign_budget resource.
- Removed click_type segment from AdGroupAsset, CampaignAsset, and CustomerAsset views.
- ShareablePreviewService.GenerateShareablePreviews: Requests will fail and throw an error if any ID within it fails validation.
- ShareablePreviewError legacy codes updated.
- Error codes returned for asset groups are modified to align with ad group ad errors. Update validation catch logic.
Features and updates (non-breaking)
- Mutability of VideoResponsiveAdInfo: Responsive video ads information objects are now mutable.
- Assets: Added travel_feed_data in AssetSet to retrieve travel feed assets attributes.
- Campaigns: Added Campaign.view_through_conversion_optimization_enabled field to allow enabling View-Through Conversion (VTC) Optimization.
- CampaignCriterion.gender: Enabled gender exclusions for Performance Max campaigns on all Google Ads API versions.
- Conversions: Added new GA4/Firebase conversion action type enums in ConversionActionType.
- General: Added UserListErrorEnum.DUPLICATE_LOOKALIKE enum value / error.
- Planning: Added plannable product description, marketing objective, cost model, and buying method to ProductCoreAttributes under ListPlannableProductsResponse.
- Reports: Added CartDataSalesView reporting resource.
- Added non-biddable metrics to all matching resources.
- Added conversion_attribution_event_type segment to ShoppingPerformanceView.
- Shopping: Supported App campaigns inside the ShoppingProduct resource.
- Tag-based product filtering introduced with new criterion types and shared set types.
- Videos: Added DataLink.youtube_video.channel_id field.
- Mar 25, 2026
- Date parsed from source:Mar 25, 2026
- First seen by Releasebot:Mar 26, 2026
- Modified by Releasebot:Jul 14, 2026
v23.2 (2026-03-25)
Google Ads API releases v23.2 with broader reporting, planning, and campaign controls, plus new asset and creator insights resources. It adds video enhancement and app asset combination views, expands Reach Plan forecasting, and introduces YouTube Live preview support.
The following new features and updates were added in Google Ads API v23.2. Minor versions like v23.2 don't contain breaking changes.
Assets
- Added VideoEnhancement resource containing enhancement-specific video ad information.
- Added AppTopCombinationView resource for insights into top-performing asset combinations in App campaigns.
- Added support to retrieve CustomerAsset with field_type set to BUSINESS_LOGO.
Campaigns
- Added more granular scheduling constraints over campaign dates for some ad group types.
- Added ability to disable the hotel feed in Demand Gen campaigns.
General
- Added new error codes MAX_CUSTOMER_LIMIT_REACHED and ACCOUNT_CREATION_POLICY_VIOLATION.
Conversions
- An error is now thrown when attempting to use the sunsetted user list customer type category LOYALTY_SIGN_UPS.
Planning
- Added support for custom AND/OR combinations of entities, topics, and audiences in GenerateTrendingInsights and GenerateCreatorInsights.
- Added new targetable age ranges in ReachPlanService.GenerateReachForecast.
- Added youtube_select_lineup_targeting field in ReachPlanService.ListPlannableProducts to replace youtube_select_lineups.
- Added IN_STREAM_NON_SKIPPABLE_THIRTY_SECONDS as a surface option in ReachPlanSurface.
- Added clicks for Demand Gen Max Clicks (CPC) in ReachPlanService.GenerateReachForecast.
- Added partnership_opportunities field to ContentCreatorInsightsService.
Reports
- Added biddable_indirect_install_first_in_app_conversion_micros field to Campaign, Customer, and AdGroup resources.
- Added ShareablePreviewService with support for YouTube Live previews and new error codes.
- Feb 25, 2026
- Date parsed from source:Feb 25, 2026
- First seen by Releasebot:Jun 25, 2026
- Modified by Releasebot:Jul 14, 2026
v22.1 (2026-02-25)
Google Ads API adds EU political advertising declaration fields and campaign filtering in v22.1.
The following new feature was added in Google Ads API v22.1. Minor versions like v22.1 don't contain breaking changes.
Account management
- Added Customer.contains_eu_political_advertising field to retrieve account-level declaration status for political advertising targeted towards the EU.
Campaigns
- Added support for querying and filtering campaigns missing declarations about whether they contain political advertising targeted towards the EU.
- Feb 25, 2026
- Date parsed from source:Feb 25, 2026
- First seen by Releasebot:Jun 25, 2026
- Modified by Releasebot:Jul 14, 2026
v21.1 (2026-02-25)
Google Ads API adds EU political advertising declaration fields and campaign filtering in v21.1.
The following new features and updates were added in Google Ads API v21.1. Minor versions like v21.1 don't contain breaking changes.
Account management
- Added Customer.contains_eu_political_advertising field to retrieve account-level declaration status for political advertising targeted towards the EU.
Campaigns
- Added support for querying and filtering campaigns missing declarations about whether they contain political advertising targeted towards the EU.
- Feb 25, 2026
- Date parsed from source:Feb 25, 2026
- First seen by Releasebot:Feb 26, 2026
- Modified by Releasebot:Jul 14, 2026
v23.1 (2026-02-25)
Google Ads API adds v23.1 updates with new account management fields, EU political advertising support, campaign text guidelines for Performance Max and Search, expanded reporting segments and metrics, planning date breakdowns, and several new enums, errors, and video data link fields.
The following new features and updates were added in Google Ads API v23.1. Minor versions like v23.1 don't contain breaking changes.
Account management
- Added advertising_partner_properties.allowed_domain field to ProductLinkInvitation and ProductLink resources.
- Added Customer.contains_eu_political_advertising field to retrieve account-level declaration status for political advertising targeted towards the EU.
Campaigns
- Added support for text guidelines in Performance Max and Search campaigns to control AI-generated text assets.
- Added new enum values for CampaignPrimaryStatusReason.
- Added support for reservation ad category self disclosure and read-only booking details in Campaign.VideoCampaignSettings.
- Added support for querying campaigns missing EU political advertising declarations.
Conversions
- Added ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS enum value.
- Added CriterionErrorEnum.CANNOT_TARGET_ONLY_UNDETERMINED enum value.
Incentives
- Added new error codes MAX_INCENTIVES_REDEEMED and ACCOUNT_TOO_OLD.
Planning
- Added support for date breakdowns using BreakdownDefinition.
- Added new segments and metrics for reports including mobile_device_platform and others.
Videos
- Added DataLink.youtube_video.channel_id field.
- Jan 28, 2026
- Date parsed from source:Jan 28, 2026
- First seen by Releasebot:Jan 29, 2026
- Modified by Releasebot:Jul 14, 2026
v23 (2026-01-28)
Google Ads API releases v23 with major breaking changes and new capabilities, including fresh ad format types, expanded reporting resources, Multi-Party Authorization reviews, and YouTube video upload support.
The following new features, updates, and breaking changes were added in Google Ads API v23, which is a major release.
See Upgrade to the latest version for guidance.
Breaking changes:
- Ads: Ad sharing among multiple ad groups is no longer permitted; requests attempting to share ads will return an AD_SHARING_NOT_ALLOWED error.
- Support for call ads has been removed.
- Campaigns: Use new date-time fields for campaign start and end dates; original date-only fields are removed.
- Demand Gen: The lead_form_only field has been removed.
- Reports: Removed aggregate asset performance label metrics.
Features and updates (non-breaking):
- Added new format types: TEXT, VERTICAL_ADS_BOOKING_LINK, and VERTICAL_ADS_PROMOTION.
- Added new metrics and fields across Ads, Assets, Campaigns, Conversions, Planning, Reports, Shopping, Videos, and more.
- Added support for Multi-Party Authorization (MPA) reviews.
- Added new reporting resources and segments.
- Added support for YouTubeVideoUpload service and resource.
- Oct 15, 2025
- Date parsed from source:Oct 15, 2025
- First seen by Releasebot:Jun 25, 2026
- Modified by Releasebot:Jul 14, 2026
v22 (2025-10-15)
Google Ads API releases v22, a major update with new fields and enum values across Ads, Assets, Campaigns, Conversions, Planning, Reports, Shopping, and Videos, plus support for Multi-Party Authorization reviews. It also includes several breaking changes and renamed metrics.
The following new features, updates, and breaking changes were added in Google Ads API v22, which is a major release.
See Upgrade to the latest version for guidance.
Breaking changes
- Demand Gen: Rename of BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros to minimum_budget_amount_micros.
- General: No operations limit in AddBatchJobOperations; ensure no single request contains more than 10,000 operations.
- ListBatchJobResultsRequest page size capped at 1,000; larger sizes return INVALID_PAGE_SIZE error.
- Performance Max: Asset performance labels support and associated enums removed.
- Campaigns: Campaign.url_expansion_opt_out removed; use final URL expansion text asset automation setting instead.
Planning: Replace references to views with new trueview_views field in ReachPlanService.
Videos: Renamed video metrics to represent TrueView video views.
Features and updates (non-breaking)
- Added new enum values and fields across Ads, Assets, Campaigns, Conversions, Planning, Reports, Shopping, Videos, and more.
- Added support for Multi-Party Authorization (MPA) reviews.
- Oct 15, 2025
- Date parsed from source:Oct 15, 2025
- First seen by Releasebot:Jan 15, 2026
- Modified by Releasebot:Jul 8, 2026
v22 (2025-10-15)
Google Ads API releases v22 with major breaking changes and broader feature support, including generative AI for text and image assets, new App campaign goals, fixed share of voice bidding, stronger Performance Max reporting, and updates across shopping, targeting, videos, and approvals.
The following new features, updates, and breaking changes were added in Google Ads API v22, which is a major release.
See Upgrade to the latest version for guidance.
Breaking changes:
- Demand Gen: Rename of BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros to minimum_budget_amount_micros.
- General: No operations limit in AddBatchJobOperations; ensure no single request contains more than 10,000 operations.
- General: Silently capped page size at 1,000 in ListBatchJobResultsRequest; requesting larger page size results in error.
- Performance Max: Asset performance labels support and associated enum removed.
- Campaigns: Campaign-level URL expansion opt-out field removed; use final URL expansion text asset automation setting.
- Planning: Replace references to views with new trueview_views field in ReachPlanService.
- Videos: Renamed video metrics to TrueView video views.
Features and updates (non-breaking):
- Added support for generating text and image assets using generative AI (Beta).
- Added new goals for App campaigns for installs to optimize without specifying a target.
- Added support for fixed share of voice bidding strategy type.
- Added support for campaign feed types indicating business vertical.
- Allowed attaching negative keywords shared sets to multi-channel and local campaigns.
- Added bidding strategy to maximize clicks at target CPC.
- Added new enum values for asset automation types.
- Added support for mutating advertiser attestation fields early for v22 and higher.
- Added support for multi-party approvals (MPA) reviews (backported to v23.3, v22.2, and v21.2).
- Added support for incentive fetching with graceful fallback on invalid email.
- Added new fields and enums for content creator insights and trending insights.
- Added new reporting resources and segments for Performance Max campaigns.
- Added new fields for shopping, targeting, videos, and reporting.
- Aug 6, 2025
- Date parsed from source:Aug 6, 2025
- First seen by Releasebot:Jun 25, 2026
- Modified by Releasebot:Jul 14, 2026
v21 (2025-08-06)
Google Ads API releases v21 with a major update that adds support for multi-party approvals reviews and introduces important changes across campaigns, conversions, EU political advertising, Performance Max, and planning.
The following new features, updates, and breaking changes were added in Google Ads API v21, which is a major release.
See Upgrade to the latest version for guidance.
Breaking changes:
- Campaigns: Returns CriterionError.INVALID_LISTING_GROUP_HIERARCHY and CriterionError.LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION error code changes.
- Conversions: Removal of debug_enabled mode in ConversionUploadService.
- EU political advertising changes: Required contains_eu_political_advertising field for new campaigns; campaigns declared as CONTAINS_EU_POLITICAL_ADVERTISING will no longer serve in the EU starting September 22, 2025.
- Modifiable criteria without self-declaration: Fails updates with CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION.
- Experiments without self-declaration requirements: Fails updates with ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION.
- Performance Max: brand_guidelines_enabled defaults to false; defaults to true for new campaigns.
- Planning: Original input argument type for AudienceInsightsService.GenerateTargetingSuggestionMetrics updated.
Features and updates (non-breaking):
- Added support for multi-party approvals (MPA) reviews.
- Aug 6, 2025
- Date parsed from source:Aug 6, 2025
- First seen by Releasebot:Jan 15, 2026
v21 (2025-08-06)
Google Ads releases a sweeping update with AI Max for Search, asset automation, expanded ad group controls, and new reporting views plus EU political advertising safeguards. It also adds Smart Bidding Exploration, Campaign asset management, and Video/Reporting enhancements.
AI Max for Search campaigns
- You can now use the ai_max_setting.enable_ai_max field of the Campaign to enable AI Max for Search campaigns. AI Max for Search campaigns expands a Search campaign's reach through search term matching and allows controlling whether targeting and creative controls serve when set. Text asset automation and brand list controls that were set in previous version requests will still be respected until AI Max for Search campaigns is explicitly toggled and turned off. Campaign.ai_max_setting.bundling_required can be used to determine if AI Max for Search campaigns must be enabled to respect or modify text asset automation and brand list controls. AdGroup.ai_max_ad_group_setting.disable_search_term_matching can be used to disable search term matching when a parent campaign has enabled AI Max for Search campaigns. See our blog post Unlock next-level performance with AI Max for Search campaigns.
- Added CampaignError.AI_MAX_MUST_BE_ENABLED, which is thrown for Search campaigns when you opt in to FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION without enabling AI Max for Search campaigns on the campaign.
- Added support for applying targeting controls at the ad group level in AI Max for Search campaigns. You can now add the following criteria to ad groups:
- Brand lists
- Locations
- Webpages (URL rules)
- Added the ai_max_search_term_ad_combination_view to report on performance for combinations of search terms, headlines, and landing pages. This view shows which search queries triggered your ads and how those specific combinations performed. A future release will include an additional view that also includes Performance Max data. If you want to avoid migrating your implementation to get Performance Max data, consider waiting for that release.
- Added AI_MAX as a new value for the search_term_match_type segment.
Assets
- Added the fields terms_and_conditions_text, terms_and_conditions_uri, promotion_barcode_info, and promotion_qr_code_info in PromotionAsset. Barcode and QR code fields are located within the promotion_trigger oneof. See the Help Center article About promotion assets.
- Added FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION to AssetAutomationTypeEnum. With this setting, you can control the automatic generation of text assets and landing pages from the final URL in Search campaigns.
- Added a new service AutomaticallyCreatedAssetRemovalService.RemoveCampaignAutomaticallyCreatedAsset to remove automatically created assets from Campaign. This service supports removal of the final URL expansion asset only.
- Added DESCRIPTION_PREFIX to the ServedAssetFieldType enum. This corrects an issue where the served_asset_field_type in ad_group_ad_asset_combination_view was UNKNOWN for assets serving as a description prefix.
Campaigns
- Added a new enum value MISSING_LOCATION_TARGETING to CampaignPrimaryStatusReason. This new status reason will be returned only for location-restricted campaigns which don't specify location targeting. For location-restricted campaigns, any attempt to add location targeting outside the allowed area will result in the criterion error LOCATION_TARGETING_NOT_ELIGIBLE_FOR_RESTRICTED_CAMPAIGN.
- Added support for third-party integration partners on the VideoCustomer.third_party_integration_partners and Campaign.third_party_integration_partners levels. See the Help Center article Track app conversions with third-party app analytics.
- You can now set the advertising_partner_ids field for an existing Campaign. Previously, this field could only be set for a new campaign during its creation. The field is still immutable after being set.
- By using a shared list of type TYPE_PLACEMENT_LIST defined at the manager account level, advertisers can now use CustomerNegativeCriterion criteria to exclude a list of placements in individual advertiser customer accounts.
- Added DESCRIPTION_PREFIX to the ServedAssetFieldType enum. This corrects an issue where the served_asset_field_type in the ad_group_ad_asset_combination_view was UNKNOWN for assets serving as a description prefix.
- Added support for the field target_roas_tolerance_percent_millis in the MaximizeConversionValue and TargetRoas bidding strategies. TargetRoas.target_roas_tolerance_percent_millis is only available for portfolio strategies, which is only available for Search campaigns.
- Changed a ProductGroup error code. For requests with a partial failure enabled, LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION will be returned instead of INVALID_LISTING_GROUP_HIERARCHY.
- Added a new resource LocationInterestView that summarizes the performance of adgroup location interest criteria.
Conversions
- Added ENGAGED_VIEW as a new value for the conversion_attribution_event_type segment.
- Customers will no longer have access to debug_enabled mode in ConversionUploadService. This field, if set to TRUE, was earlier used to distinguish the CLICK_NOT_FOUND error from SUCCESS for enhanced conversions for leads imports.
Demand Gen
- Added an error code CampaignBudgetError.BUDGET_BELOW_DAILY_MINIMUM. In the future, this error will be returned when attempting to set a very low budget amount for a Demand Gen campaign. Details about the required minimum budget can be found in the new error details field budgetDailyMinimumErrorDetails.
EU political advertising changes
These EU political advertising changes have also been made in the v19.2 and v20.1 releases.
- Added Campaign.contains_eu_political_advertising. This field indicates whether your campaign contains political advertising content targeted towards the European Union. If this field is set to CONTAINS_EU_POLITICAL_ADVERTISING, the campaign will no longer serve in the EU starting September 22, 2025. API calls to create a new campaign will fail with a FieldError.REQUIRED error if this field is not set.
- For any existing campaigns, you should set the contains_eu_political_advertising field before attempting to change proximity, location, or location group targeting either at the campaign or ad group levels. The API calls to create or update these campaign or ad group criteria for existing campaigns will fail with a CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION error if the campaign hasn't completed the self-declaration.
- For versions v19.x and 20.x, the requirement to set this field is not yet enforced, but will be in the future. This change will be announced in advance.
- Trials and Experiments will throw an ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION if the experiment's campaigns haven't self-declared whether they contain political advertising that targets the European Union.
Performance Max
- For new PMax campaigns the default value of Campaign.brand_guidelines_enabled is now true.
- Added the campaign_search_term_view report. This view offers search terms metrics aggregated at the campaign level. This view also introduces Performance Max campaign support for search terms.
- Added PERFORMANCE_MAX as a new value for the search_term_match_type segment.
Planning
- Added a new method ReachPlanService.ListPlannableUserInterests, which allows advertisers to discover the user interests (affinities and in-markets) supported by ReachPlanService.GenerateReachForecast. The method supports searching for specific user interest types and querying for names and paths.
- Added AdditionalApplicationInfo to ReachPlanService.ListPlannableUserLists as an optional input field.
- Added support to AudienceInsightsService.ListAudienceInsightsAttributes to fetch available 1P user lists for the customer ID making the request.
- Added 1P user lists support to AudienceInsightsService.GenerateAudienceCompositionInsights to fetch insights for audiences targeting a user list. Any request that targets a user list will only return the audience index and is only available for the following AudienceInsightsDimension: AGE_RANGE, GENDER, AFFINITY_USER_INTEREST, IN_MARKET_USER_INTEREST.
- Updated the audience input type to InsightsAudience for AudienceInsightsService.GenerateTargetingSuggestionMetrics. The new audience input allows an AND-of-ORs combination of user interests, supporting potential reach metrics for more customized audience definitions.
- Added audience share to TrendInsightMetrics to get the share of an audience for a trend.
- Added new related categories to KnowledgeGraphAttributeMetadata so users can filter Knowledge Graph Attributes by category.
Reports
- A variety of new metrics are now available for AssetGroupAsset, ChannelAggregateAssetView, and CampaignAggregateAssetView. Additionally, for ChannelAggregateAssetView and CampaignAggregateAssetView, impressions, which was previously zeroed out for Performance Max campaigns, will now report its true value.
- Made the AssetSet resource selectable with ChangeStatus so users can make get more info about the AssetSet or CampaignAssetSet type resource in one query.
- Made the CampaignAssetSet resource selectable with ChangeStatus so users can make get more info about the AssetSet or CampaignAssetSet type resource in one query.
- Added a new segment search_term_targeting_status that can be selected in campaign search term view.
- Added a new final_url_expansion_asset_view.
- Added support for metrics value_adjustment and all_value_adjustment in the AssetGroup report.
- Made AssetGroupAsset segmentable by ad_network_type.
- Added a new segment landing_page_source that can be used with the landing_page_view resource.
- Added a new segment search_term_match_source that can be selected in the search term and campaign search term views.
- Added a new segment match_type that can be selected from the keyword view.
- Added support for metrics for unique query intent clusters with:
- clicks_unique_query_clusters
- conversions_unique_query_clusters
- impressions_unique_query_clusters
- Added a new click type VEHICLE_ASSETS in the click_view segmentation to track and report clicks related to the ad formats specific to vehicle assets.
Smart Bidding Exploration for Target ROAS bidding strategies on Search
- You can now enable Smart Bidding Exploration on Search campaigns by setting the field target_roas_tolerance_percent_millis in the MaximizeConversionValue and TargetRoas bidding strategies to any value divisible by 1000 between 10000 (10%) and 30000 (30%) inclusive. MaximizeConversionValue bidding strategies will also need the target_roas field set. TargetRoas.target_roas_tolerance_percent_millis is only available for portfolio strategies. See our blog post on Smart Bidding Exploration and help center article.
- Aggregated diversity reporting is now supported for the following metrics for unique query intent clusters. A time segmented view is available in the Google Ads UI.
- clicks_unique_query_clusters
- conversions_unique_query_clusters
- impressions_unique_query_clusters
Video
- Added YouTubeVideoListAsset. Also added Asset#youtube_video_list_asset, which can be used to create link between a campaign and a YouTubeVideoListAsset type. See the Help Center article Use related videos.
- Added new metadata fields to YouTubeChannelInsights and YouTubeVideoAttributeMetadata.
- Exposed new click types: VIDEO_RELATED_VIDEOS_CLICK, VIDEO_CHANNEL_CLICK, and PRODUCT_ASSETS.
- Added the allow_non_skippable_in_stream field to VideoAdInventoryControl to let Video Responsive ads serve as non-skippable in-stream ads. This option is available for campaigns that support mixing the non-skippable format with other formats.
- Added the Campaign.VideoCampaignSettings.video_ad_sequence and AdGroup.VideoAdGroupSettings.VideoAdSequenceStepSetting fields (read-only). See the Help Center article About video ad sequencing.
- Added new metadata fields to YouTubeChannelInsights and YouTubeVideoAttributeMetadata.
- Added the VIDEO_LINEUP criterion type and the video_lineup field to CampaignCriterion and AdGroupCriterion. This feature is available to allowlisted accounts only. Contact your Google business development representative for details.
- Added a Content Suitability report for both the detail and the group level. See the Help Center article About the 'Content suitability' report.
Curated by the Releasebot team
Releasebot is an aggregator of official product update announcements from hundreds of software vendors and thousands of sources.
Our editorial process involves the manual review and audit of release notes procured with the help of automated systems.