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.

v22 (2025-10-15)

The following new features and updates were added in v22.

See Upgrade to the latest version for guidance.

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.

v19.2 (2025-08-06)

These EU political advertising changes have also been made in the v20.1 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. Wait for the announcement of this change.

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

v19.1 (2025-04-16)

The following features and changes were added in v19.1.

Assets

Campaigns

Demand Gen

Change History

  • Added support for three more resource types into ChangeStatusResourceType:
    • CAMPAIGN_BUDGET
    • ASSET_SET
    • CAMPAIGN_ASSET_SET
  • You can retrieve these three finer-grained types from the change_status report.

Conversions

Local Services Ads

Planning services

  • Added support for Target frequency monthly forecasts in ReachPlanService.GenerateReachForecast.
  • Added a new method ReachPlanService.GenerateConversionRates, which allows advertisers to request suggested conversion rates for supported plannable products.
  • Demand Gen forecasting in ReachPlanService.GenerateReachForecast:
    • Developers can now request reach forecasts for Demand Gen campaigns. Developers can use the new DEMAND_GEN_MAX_CONVERSIONS plannable product code to generate Demand Gen reach forecasts.
    • Added a new conversion_rate field that allows developers requesting Demand Gen reach forecasts to provide a conversion rate. Suggested conversion rates can be retrieved using the new ReachPlanService.GenerateConversionRates method. This field is required for Demand Gen forecasting requests. It is not supported for other plannable products.
    • Added a new conversions field to returned forecasts. This field contains the number of conversions at a given point on the reach curve. Conversions are only supported for the DEMAND_GEN_MAX_CONVERSIONS plannable product.

Recommendations

Videos

  • Added read-only support for Audio Ads. See Google Ads Help Center to learn about this feature. This change exposes:
  • Added new metrics and segments to query reach metrics with demo adjustment. As part of these changes,
    • Two new metrics columns named coviewed_impressions and primary_impressions were introduced.
    • Two new segments named adjusted_age_range and adjusted_gender were introduced.
    • If either of the two new segments are selected alongside a reach metric field (coviewed_impressions, primary_impressions, unique_users, or average_impression_frequency_per_user), the other segment must be selected as well to retrieve valid stats for these columns.
    • This feature is currently available only for allowlisted customers.

v19 (2025-02-26)

The following features and changes were added in v19.

See Upgrade to the latest version for guidance.

Account Management

  • Added the following values to CustomerError to account for upcoming changes:
    • CREATION_DENIED_FOR_POLICY_VIOLATION
    • CREATION_DENIED_INELIGIBLE_MCC

Ads

Assets

Conversions

Feeds

  • Removed all feed-related entities, such as Feed, FeedMapping, FeedService, AdGroupFeed, feed_placeholder_view, etc. Users should now use assets to achieve the same purpose.

Hotel & Travel

Performance Max

Planning

Videos

Archived release notes

See Sunsetted versions for archived release notes.