Wednesday, January 28, 2026


Today, we're announcing the v23 release of the [Google Ads API](https://developers.google.com/google-ads/api). This marks the first release of 2026 and the beginning of our move to a [faster release cadence](https://developers.google.com/ads/blog/posts/2025/09/more-frequent-releases-coming-for.md.txt).


To use some of the v23 features, you must upgrade your [client libraries](https://developers.google.com/google-ads/api/docs/client-libs.md.txt) and client code. All the updated client libraries and code examples have been published.


Here are some of the key features in this release:

- Enabled ad network type breakdown for Performance Max campaigns.
- `InvoiceService.ListInvoices` can now return more granular details in `Invoice` including campaign-level cost breakdown, itemized regulatory costs, and adjustment information. To get these details, set `include_granular_level_invoice_details` in `ListInvoicesRequest`.
- You can now specify start and end times for certain campaign types. The new fields `Campaign.start_date_time` and `Campaign.end_date_time` replace `Campaign.start_date` and `Campaign.end_date`, respectively.
- Store location details are now available in [PerStoreView](https://developers.google.com/google-ads/api/reference/rpc/v23/PerStoreView.md.txt). You can retrieve the store location column shown in the Stores report via the API.
- Added a new `LIFE_EVENT_USER_INTEREST` dimension. This allows users to build audiences using Life Events with `AudienceInsightsService` and `ContentCreatorInsightsService`.
- The `ReachPlanService.GenerateConversionRates` response now includes surfaces, allowing for different conversion rate suggestions based on surface controls (for example, Gmail, Shorts). This is only supported for Demand Gen campaigns.
- Added a new `AudienceInsightsService.GenerateAudienceDefinition` method that lets you to translate a free text description of a target audience into matching audience attributes using generative AI.
- `ShoppingPerformanceView` now supports new competitive metrics and conversion metrics segmented by conversion date.

<br />


**Where can I learn more?**


The following resources can help you get started:

- [Release Notes](https://developers.google.com/google-ads/api/docs/release-notes.md.txt)
- [Upgrade from a previous version](https://developers.google.com/google-ads/api/docs/upgrade.md.txt)
- [Guides](https://developers.google.com/google-ads/api/docs)
- [Reference](https://developers.google.com/google-ads/api/reference/rpc)
- [Diff between v23 and v22](https://developers.google.com/google-ads/api/docs/diff)


Come join us for a walkthrough of this release in our ["Google Ads API Release Highlights" event on Discord](https://discord.gg/8ZfJwf4M?event=1463213281895252101) on January 29th at 11am ET. If you have any questions or want to discuss this post, reach out to us in the #ads-api channel there.


For technical support issues, reach out to <https://support.google.com/google-ads/gethelp>

[![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)