Announcing v23 of the Google Ads API

Today, we’re announcing the v23 release of the Google Ads API. This marks the first release of 2026 and the beginning of our move to a faster release cadence.

To use some of the v23 features, you must upgrade your client libraries 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. 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.

Where can I learn more?

The following resources can help you get started:

• Release Notes
• Upgrade from a previous version
• Guides
• Reference
• Diff between v23 and v22

Come join us for a walkthrough of this release in our "Google Ads API Release Highlights" event on Discord 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

 - Anash P. Oommen, Google Ads API Team