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.

v23 (2026-01-28)

The following new features and updates were added in v23.

See Upgrade to the latest version for guidance.

Ads

  • Added AD_SHARING_NOT_ALLOWED to AdGroupAdErrorEnum. This error is returned when attempting to share an ad among multiple ad groups, which is no longer allowed.
  • Added new format types to AdFormatType: TEXT, VERTICAL_ADS_BOOKING_LINK, VERTICAL_ADS_PROMOTION.
  • Removed support for CallAd and CallAdInfo in v23. See https://support.google.com/google-ads/answer/6341403 to learn more.

Assets

Billing

Campaigns

Conversions

  • Added YOUTUBE_FOLLOW_ON_VIEWS to ConversionActionCategory to support tracking users who watch an ad and later watch a video from the same channel.

Demand Gen

Incentives

  • Added support for Choose Your Own (CYO) incentives, allowing partners to programmatically fetch and apply Google Ads incentives for their customers:

  • To facilitate more granular programmatic handling of failures, we will add additional error codes to IncentivesService in future releases. We recommend that you monitor upcoming announcements and release notes for these new error codes to make sure your applications can manage these new failure modes.

Planning

Recommendations

  • Added is_new_customer field to GenerateRecommendationsRequest. When set to true for recommendations of type CAMPAIGN_BUDGET, it generates recommendations using a model for new customers. This is only recommended for customers with no campaigns.

Reports

Shopping

  • ShoppingPerformanceView now supports the following metrics segmented by conversion date: conversions_by_conversion_date, all_conversions_by_conversion_date, conversions_value_by_conversion_date, all_conversions_value_by_conversion_date, value_per_conversions_by_conversion_date, value_per_all_conversions_by_conversion_date.
  • ShoppingPerformanceView now supports the following competitive metrics: search_budget_lost_impression_share, search_rank_lost_impression_share, search_budget_lost_absolute_top_impression_share, search_rank_lost_absolute_top_impression_share.
  • Added product_image_uri to ShoppingProduct.

Vertical ads

  • Added the vertical_ads_format_setting to AdGroup for Search campaigns using travel feeds, allowing control over which ad formats can serve.
  • Added the vertical_ads_item_group_rule_list criterion type to AdGroupCriterion. Added vertical_ads_item_group_rule to SharedCriterion. These criteria permit targeting item groups in Search Campaigns with travel feeds.
  • You can now connect a vertical ads data feed to a search campaign that is running AI Max so that it shows property promotion and booking link travel ads alongside your text ads. At the ad group level, you can control which formats to show with the vertical_ads_format_setting and define a set of item group rules to target a subset of your entities from the Vertical Ads Data Feed. Additionally, reporting can now be segmented both by AdFormatType and dimensions from the vertical ads data feed.

Video

v22 (2025-10-15)

The following new features and updates were added in v22.

Assets

  • Added LANDING_PAGE_PREVIEW as a new image asset field type.
  • Introduced the AssetGenerationService (Beta):
    • This service allows generating text and image assets using generative AI. This service is initially available only to a limited set of closed beta participants.
    • GenerateText: Generates text based on inputs like final URL, freeform prompts, keywords, and existing campaign context.
    • GenerateImages: Generates images based on inputs like final URL, freeform prompts, existing campaign context, or by recontextualizing existing product images.
    • Errors during asset generation are returned with codes from AssetGenerationErrorEnum.

Campaigns

Demand Gen

General

  • Added a limit of 10,000 operations per AddBatchJobOperations request.
  • Updated handling for the page_size field in ListBatchJobResultsRequest:
    • If page_size is not set or is 0, it now defaults to the maximum of 1,000 (previously returned INVALID_PAGE_SIZE).
    • If page_size exceeds 1,000, the API now returns an INVALID_PAGE_SIZE error (previously silently capped at 1,000).
  • Added a new error code: QuotaError.PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED to indicate when the payment profile activation rates limit has been exceeded.

Performance Max

Planning

Reports

Unified goals

Video

v21 (2025-08-06)

See Upgrade to the latest version for guidance.

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

Campaigns

Conversions

Demand Gen

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

Planning

Reports

Video

v20.1 (2025-08-06)

These EU political advertising changes have also been made in the v19.2 and v21 releases.

EU political advertising changes

  • 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.

    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.

v20 (2025-06-04)

The following new features and updates were added in v20.

See Upgrade to the latest version for guidance.

Assets

Added several new metrics and segment columns for the asset_group report.

Metrics columns

Segment columns

Campaigns

Conversions

  • You can now update the google_ads_conversion_customer field on an existing customer to opt in to cross-account conversion tracking, or to change its existing conversion tracking parent to a different manager account.

  • Added the ClickConversion.user_ip_address field. Google Ads does not support IP address matching for end users in the European Economic Area (EEA), United Kingdom (UK), or Switzerland (CH). Please add logic to conditionally exclude sharing IP addresses from users from these regions. Make sure that you provide users with clear and comprehensive information about the data you collect on your sites, apps, and other properties and get consent where required by law or any applicable Google policies. See the About offline conversion imports page for more details.

Demand Gen

Recommendations

  • Added support for ShoppingSetting during campaign construction when using GenerateRecommendationsRequest.
    • Added the merchant_center_account_id field to GenerateRecommendationsRequest to indicate when recommendations should be generated for retail, rather than the standard Performance Max campaigns.

Planning

Videos

  • Added AdFormatType.PAUSE ads served on organic YouTube videos on TV screens, which is included in reporting. These ads are displayed directly next to the static video frame on the pause screen. This does not include Demand Gen video ads displayed on the ad panel below or on top of a paused organic video, which are reported under AdFormatType.INFEED.

Archived release notes

See Sunsetted versions for archived release notes.