Wednesday, September 23, 2026


Today we are announcing the release of v25.2 of the Google Ads API. To use the new capabilities, you must upgrade your [client libraries](https://developers.google.com/google-ads/api/docs/client-libs.md.txt?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v25-2&utm_content=learnmore-clientlibs) and client code. All the updated client libraries and code examples have been published.


Come join us for a live walkthrough of this release in our [Google Ads API Release Highlights event on Discord](https://discord.gg/teFpK7GwH?event=1547900086065823833) or our [Ads Developers YouTube Live](https://www.youtube.com/watch?v=vultEWFPISo) tomorrow (September 24th at 10am ET). This will also be recorded and posted on YouTube for those who can't make the live events. If you have any questions or want to discuss this post, reach out to us in the [#ads-api channel](http://goo.gle/ads-and-measurement-discord) on Discord.

## New Features

<br />


Here are the highlights of what's new in v25.2:

- **Competitive benchmarks percentile metrics** : `BenchmarksService.GenerateBenchmarksMetrics` now surfaces metrics representing your competitive standing among other advertisers in percentile tier format using `PercentileMetrics` and `BenchmarksCustomerPercentileTier`. You can request this data by adding `PERCENTILE_DATA` to `supplemental_data`, setting `benchmarks_source` to `ALL_ADVERTISERS` and specifying the `category_filter`.
- **Generate Performance Max drafts from Smart campaigns** : The new `SmartCampaignSettingService.GeneratePMaxDraftCampaign` method allows you to programmatically generate a Performance Max draft campaign directly from an existing Smart campaign, simplifying your campaign upgrade workflows.
- **Asset group URL options** : You can now configure tracking templates (`tracking_url_template`), custom parameters (`url_custom_parameters`), and final URL suffixes (`final_url_suffix`) directly at the asset group level on `AssetGroup` for Performance Max campaigns.
- **Creator insights by YouTube channel handles** : `ContentCreatorInsightsService.GenerateCreatorInsights` now supports searching directly by [YouTube channel handles](https://developers.google.com/google-ads/api/reference/rpc/v25/GenerateCreatorInsightsRequest.YouTubeChannels.md.txt?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v25-2&utm_content=learnmore-refdocs#youtube_channel_handles[]) in addition to channel IDs, streamlining your creator discovery process.
- **Vertical ads itinerary dimensions and price competitiveness** : For hotel and travel advertisers, we've added new itinerary dimension segments (`advance_booking_window`, `length_of_booking`, `start_date`, `start_day_of_week`, `user_set_dates`) along with new vertical ads metrics metrics and segments such as `vertical_ads_price_difference_percentage`, `vertical_ads_price_tier` and `vertical_ads_potential_impressions`.
- **Search bid adjustment recommendations** : New recommendations (`raise_target_cpa_performance_bid_too_low_recommendation` and `lower_target_roas_performance_bid_too_low_recommendation`) notify you when Target CPA or Target ROAS bids are too low for Search campaigns to enter auctions.

## Getting started


Google Ads API v25.2 is a drop-in upgrade for v25. If you use our client libraries, download the latest version of your client library to start using these features. Review the [official release notes](https://developers.google.com/google-ads/api/docs/release-notes.md.txt?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v25-2&utm_content=learnmore-releasenotes#v25-2-2026-09-17) for a full list of changes. If you have any questions or want to discuss this post, reach out to us on our [Google Advertising and Measurement Community Discord server](http://goo.gle/ads-and-measurement-discord).


For technical support issues, please reach out to the [Google Ads API support channel](https://support.google.com/google-ads/contact/google_ads_api).

[![Portrait of the author](https://developers.google.com/static/ads/blog/images/AD_cMMRmfdsXvZhyLvWsLuqqcScxtYI0ih7DPGCk8lTee140NzXH=s300.jpg)](https://g.dev/anash) - [Anash P. Oommen](https://g.dev/anash), Google Ads API Team

**Labels:**

[google-ads-api](https://developers.google.com/ads/blog/feeds/labels/google-ads-api.md.txt),

[release](https://developers.google.com/ads/blog/feeds/labels/release.md.txt)