Wednesday, April 22, 2026
Today, we're announcing the v24 release of the [Google Ads API](https://developers.google.com/google-ads/api?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v24&utm_content=learnmore-api). To use the new v24 features, 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-v24&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.com/events/971845904002871346/1492135554966360125), our [Ads Developers YouTube Live](https://www.youtube.com/watch?v=sw_YjsWhYlY), or our [LinkedIn Live event](https://www.linkedin.com/events/7449835840215797761) tomorrow (April 23rd at 10a 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
**Support for Conversions with Cart Data:** [Conversions with cart data](https://support.google.com/google-ads/answer/9028254) is an extension to conversion tracking on your website or app. Using conversions with cart data, you can provide the details of products sold for each transaction, which helps you unlock advanced sales, profit reporting, and insights for your Google Ads account and campaigns, such as number of orders, average cart size, revenue and gross profit.
Google Ads API v24 adds support for this feature as follows:
- Added a new resource `CartDataSalesView` that allows segmenting conversion metrics not only by the product clicked, but also by the product sold, with segments like `product_sold_brand`. These enable advertisers to view statistics on the products the customers actually bought after clicking ads, even if the ad was for a different product.
- Added several "all" non-biddable metrics, which are metrics that also include the conversions your campaigns are not actively optimizing towards, for example `all_cost_of_goods_sold_micros`. The new metrics are added to all resources supporting corresponding biddable metrics.
- Added the `conversion_attribution_event_type` segment to the `ShoppingPerformanceView` resource, making it selectable with cart data and other conversion metrics. This segment denotes whether the conversion is attributed to a click or to a view and it is necessary to recognize cart data stats produced by view-through conversions.
### Updated features
Version v24 introduces updates to existing features that require code changes when upgrading. We cover the most important ones here; check out the release notes for the [full list of changes](https://developers.google.com/google-ads/api/docs/release-notes.md.txt?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v23_2&utm_content=learnmore-releasenotes).
**Video content exclusion settings in campaigns:** We simplified the ability to set [video content exclusion settings on individual campaigns](https://developers.google.com/google-ads/api/reference/rpc/v23/Campaign.md.txt?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v24&utm_content=learnmore-refdocs#video_brand_safety_suitability). This setting is available at the [customer level](https://developers.google.com/google-ads/api/reference/rpc/v24/Customer.md.txt?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v24&utm_content=learnmore-refdocs#video_brand_safety_suitability), and applies to all the campaigns instead. These content exclusion settings are meant to give you additional control and help you exclude types of content that, while in compliance with our policies, may not fit your brand or business. See to learn more about video content exclusion settings.
**Changes to AudienceInsightsService:** As part of a code refactoring, we moved the `InsightsAudience.topic_audience_combinations` request field into the `common` namespace. You may need to update your import directives in some programming languages.
**Changes to ReachPlanService:** As part of a code refactoring, we moved the `youtube_select_lineups` field from the `ReachPlanService.ListPlannableProducts` service. Lineups are now available within the `youtube_select_lineup_targeting` field. YouTube Select Lineups are [reservation products](https://support.google.com/google-ads/answer/6030919) for eligible clients to target among the top 1% of popular channels on YouTube with the most passionate audiences in a given market. [Learn more](https://blog.google/products-and-platforms/products/ads/introducing-youtube-select/).
**Changes to ContentCreatorInsightsService:** As part of a code refactoring, we removed the `is_brand_connect_creator` field from the `ContentCreatorInsightsService.GenerateCreatorInsights` and `ContentCreatorInsightsService.GenerateTrendingInsights` services.
Users should instead look for a creator to have the `CREATOR_PARTNERSHIPS` option available instead in `partnership_opportunities`. The YouTube Creator Partnerships in Google Ads is the space where you can find YouTube creators to partner with on sponsored content and help you efficiently manage your creator partnerships. [Learn more](https://support.google.com/google-ads/answer/15471603).
**Changes to KeywordPlanIdeaService:** To provide a more streamlined and reliable experience, we have unified our forecasting infrastructure. Google Ads API v24 introduces an updated `GenerateKeywordForecastMetrics` method that simplifies the planning process by focusing on the metrics that most directly impact your performance. We will share a more detailed blog post about this change in the coming days.
**Changes to campaign_budget resource:** We removed the `ad_sub_network_type` segment for the `campaign_budget` resource because it is incompatible with this view.
**Changes to asset views:** We removed the `click_type` segment from the `ad_group_asset`, `campaign_asset`, and `customer_asset` views. This change aligns with a recent product change that removed this segment from the Google Ads to avoid misrepresentation of data. You can use the `click_type` segmentation from the `ad_group_ad` resource to get details on the ad performance and the asset it was served with.
**Changes to video responsive ad: `VideoResponsiveAdInfo`** is now mutable. As part of this change, we have marked `videos`, `business_name` and `logo_images` as required fields in both the `DemandGenVideoResponsiveAdInfo` and `VideoResponsiveAdInfo` objects.
**Changes to ShareablePreviewService:** Updated `ShareablePreviewService.GenerateShareablePreviews` to not use partial failure anymore. Requests will throw an error if they fail for any ID. [Learn more](https://developers.google.com/google-ads/api/docs/release-notes.md.txt?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v24&utm_content=learnmore-refdocs#videos-v24).
The following resources can help you get started:
- [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-v24&utm_content=learnmore-releasenotes)
- [Upgrade from a previous version](https://developers.google.com/google-ads/api/docs/upgrade.md.txt?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v24&utm_content=learnmore-upgrade)
- [Guides](https://developers.google.com/google-ads/api/docs?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v24&utm_content=learnmore-guides)
- [Reference](https://developers.google.com/google-ads/api/reference/rpc/?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v24&utm_content=learnmore-refdocs)
- [Diff between v24 and v23](https://developers.google.com/google-ads/api/docs/upgrade.md.txt?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v23_2&utm_content=learnmore-upgrade?utm_source%3Dgoogleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v24&utm_content=learnmore-upgrade#v23-v24)
For technical support issues, reach out to
[](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)