Announcing v25 of the Google Ads API

<p> Today, we’re announcing the v25 release of the <a target="_blank" href="https://developers.google.com/google-ads/api?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v25&utm_content=learnmore-api">Google Ads API</a>. This major release brings support for new reporting features and goals. To use these new capabilities, you must upgrade your <a target="_blank" href="https://developers.google.com/google-ads/api/docs/client-libs?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v25&utm_content=learnmore-clientlibs">client libraries</a> and client code. All the updated client libraries and code examples have been published. </p> <p> Come join us for a live walkthrough of this release in our <a target="_blank" href="https://discord.com/events/971845904002871346/1526246330266157332">"Google Ads API Release Highlights" event on Discord</a> or our <a target="_blank" href="https://www.youtube.com/watch?v=1zUz0nyX_l8">Ads Developers YouTube Live</a> tomorrow (July 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 <a target="_blank" href="http://goo.gle/ads-and-measurement-discord">#ads-api channel</a> on Discord. </p> <h2>New Features</h2> <p> Here are the highlights of what’s new in v25: </p><ul> <li><strong>YouTube Ad sub-format breakdowns</strong>: You can break down <a target="_blank" href="https://support.google.com/google-ads/answer/11462260">YouTube instream non-skippable ads</a> by duration (<a target="_blank" href="https://developers.google.com/google-ads/api/reference/rpc/v25/AdSubFormatTypeEnum.AdSubFormatType?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v25&utm_content=learnmore-refdocs#instream_non_skippable_standard">standard</a>, <a target="_blank" href="https://developers.google.com/google-ads/api/reference/rpc/v25/AdSubFormatTypeEnum.AdSubFormatType?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v25&utm_content=learnmore-refdocs#instream_non_skippable_max30_sec">max 30s</a>, <a target="_blank" href="https://developers.google.com/google-ads/api/reference/rpc/v25/AdSubFormatTypeEnum.AdSubFormatType?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v25&utm_content=learnmore-refdocs#instream_non_skippable_max60_sec">max 60s</a>) using the new <code><a target="_blank" href="https://developers.google.com/google-ads/api/fields/v25/segments?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v25&utm_content=learnmore-refdocs#segments.ad_sub_format_type">ad_sub_format_type</a></code> segment. This segment must always be selected together with the <code><a target="_blank" href="https://developers.google.com/google-ads/api/fields/v25/segments?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v25&utm_content=learnmore-refdocs#segments.ad_format_type">ad_format_type</a></code> field, and is selectable with <code><a target="_blank" href="https://developers.google.com/google-ads/api/reference/rpc/v25/AdGroup?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v25&utm_content=learnmore-refdocs">AdGroup</a></code>, <code><a target="_blank" href="https://developers.google.com/google-ads/api/reference/rpc/v25/AdGroupAd?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v25&utm_content=learnmore-refdocs">AdGroupAd</a></code>, <code><a target="_blank" href="https://developers.google.com/google-ads/api/reference/rpc/v25/Campaign?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v25&utm_content=learnmore-refdocs">Campaign</a></code>, <code><a target="_blank" href="https://developers.google.com/google-ads/api/reference/rpc/v25/Customer?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v25&utm_content=learnmore-refdocs">Customer</a></code>, <code><a target="_blank" href="https://developers.google.com/google-ads/api/reference/rpc/v25/Video?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v25&utm_content=learnmore-refdocs">Video</a></code>, and <code><a target="_blank" href="https://developers.google.com/google-ads/api/reference/rpc/v25/VideoEnhancement?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v25&utm_content=learnmore-refdocs">VideoEnhancement</a></code> resources. <li><strong>YouTube Shorts social metrics</strong>: You can now retrieve video-specific social metrics to help track user engagement (<a target="_blank" href="https://developers.google.com/google-ads/api/reference/rpc/v25/Metrics?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v25&utm_content=learnmore-refdocs#youtube_comments">comments</a>, <a target="_blank" href="https://developers.google.com/google-ads/api/reference/rpc/v25/Metrics?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v25&utm_content=learnmore-refdocs#youtube_likes">likes</a>, and <a target="_blank" href="https://developers.google.com/google-ads/api/reference/rpc/v25/Metrics?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v25&utm_content=learnmore-refdocs#youtube_shares">shares</a>) for <a target="_blank" href="https://business.google.com/us/ad-solutions/youtube-ads/shorts-ads/">Shorts ads on YouTube</a>. These metrics are available in reports for <code><a target="_blank" href="https://developers.google.com/google-ads/api/reference/rpc/v25/AdGroup?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v25&utm_content=learnmore-refdocs">AdGroup</a></code>, <code><a target="_blank" href="https://developers.google.com/google-ads/api/reference/rpc/v25/AdGroupAd?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v25&utm_content=learnmore-refdocs">AdGroupAd</a></code>, <code><a target="_blank" href="https://developers.google.com/google-ads/api/reference/rpc/v25/Asset?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v25&utm_content=learnmore-refdocs">Asset</a></code>, <code><a target="_blank" href="https://developers.google.com/google-ads/api/reference/rpc/v25/Campaign?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v25&utm_content=learnmore-refdocs">Campaign</a></code>, <code><a target="_blank" href="https://developers.google.com/google-ads/api/reference/rpc/v25/Customer?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v25&utm_content=learnmore-refdocs">Customer</a></code>, and <code><a target="_blank" href="https://developers.google.com/google-ads/api/reference/rpc/v25/Video?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v25&utm_content=learnmore-refdocs">Video</a></code> resources. <li><strong>Loyalty retention goal</strong>: The <a target="_blank" href="https://support.google.com/google-ads/answer/14792043">retention goal in Google Ads</a> is designed to drive customer loyalty and high lifetime value (LTV) within your business. You can now optimize your campaigns for <a target="_blank" href="https://developers.google.com/google-ads/api/reference/rpc/v25/GoalTypeEnum.GoalType?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v25&utm_content=learnmore-refdocs#loyalty_retention">retaining loyalty</a> program members. Configure <a target="_blank" href="https://developers.google.com/google-ads/api/reference/rpc/v25/CampaignGoalConfig?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v25&utm_content=learnmore-refdocs#campaign_loyalty_retention_settings">campaign-specific settings</a> (including bid adjustments and showing member benefits in Product Listing Ad format) or <a target="_blank" href="https://developers.google.com/google-ads/api/reference/rpc/v25/Goal?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v25&utm_content=learnmore-refdocs#loyalty_retention_goal_settings">account-level settings</a>. <li><strong>New customer acquisition goal (Revamped)</strong>: We’ve updated the <a target="_blank" href="https://support.google.com/google-ads/answer/14005976">new customer acquisition goal</a> feature to reflect the revamped unified goals schema. The legacy <code><a target="_blank" href="https://developers.google.com/google-ads/api/reference/rpc/v24/CustomerLifecycleGoal?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v25&utm_content=learnmore-refdocs">CustomerLifecycleGoal</a></code> and <code><a target="_blank" href="https://developers.google.com/google-ads/api/reference/rpc/v24/CampaignLifecycleGoal?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v25&utm_content=learnmore-refdocs">CampaignLifecycleGoal</a></code> resources and services are removed. You should now configure these goals via the <code><a target="_blank" href="https://developers.google.com/google-ads/api/reference/rpc/v25/Goal?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v25&utm_content=learnmore-refdocs">Goal</a></code> and <code><a target="_blank" href="https://developers.google.com/google-ads/api/reference/rpc/v25/CampaignGoalConfig?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v25&utm_content=learnmore-refdocs">CampaignGoalConfig</a></code> resources. <li><strong>YouTube channel insights consent features</strong>: You can access detailed YouTube channel insights (<a target="_blank" href="https://developers.google.com/google-ads/api/reference/rpc/v25/YouTubeMetrics?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v25&utm_content=learnmore-refdocs#average_views_per_video">average views</a>, <a target="_blank" href="https://developers.google.com/google-ads/api/reference/rpc/v25/YouTubeMetrics?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v25&utm_content=learnmore-refdocs#average_likes_per_video">likes</a>, <a target="_blank" href="https://developers.google.com/google-ads/api/reference/rpc/v25/YouTubeMetrics?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v25&utm_content=learnmore-refdocs#average_comments_per_video">comments</a>, <a target="_blank" href="https://developers.google.com/google-ads/api/reference/rpc/v25/YouTubeMetrics?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v25&utm_content=learnmore-refdocs#engagement_rate">engagement rate</a>, and <a target="_blank" href="https://developers.google.com/google-ads/api/reference/rpc/v25/YouTubeChannelInsights?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v25&utm_content=learnmore-refdocs#channel_audience_attributes">audience attributes</a>) for creators who have <a target="_blank" href="https://developers.google.com/google-ads/api/reference/rpc/v25/YouTubeChannelInsights?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v25&utm_content=learnmore-refdocs#data_sharing_consent_given">consented to share non-public data</a>. </li></ul> <h2>Getting Started</h2> <p> To use the new capabilities in Google Ads API v25, download the latest version of your <a target="_blank" href="https://developers.google.com/google-ads/api/docs/client-libs?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v25&utm_content=learnmore-clientlibs">client library</a>. For a full list of changes, please review the <a target="_blank" href="https://developers.google.com/google-ads/api/docs/release-notes?utm_source=googleblog-adsdevs&utm_medium=blog&utm_campaign=adr-adsapi-release-v25&utm_content=learnmore-releasenotes#v25-2026-07-22">official release notes</a>. For technical support issues, reach out to <a target="_blank" href="https://support.google.com/google-ads/contact/google_ads_api">https://support.google.com/google-ads/contact/google_ads_api</a>. </p> <p><span class="byline-author"><a target="_blank" target="_blank" target="_blank" href="https://g.dev/anash"><img width="40" height="40" src="https://lh3.googleusercontent.com/a-/AD_cMMRmfdsXvZhyLvWsLuqqcScxtYI0ih7DPGCk8lTee140NzXH=s300" style="vertical-align:middle; border:none;"></a>&nbsp;-&nbsp;<a target="_blank" target="_blank" target="_blank" href="https://g.dev/anash" rel="author">Anash P. Oommen</a>, Google Ads API Team</span></p>

Publication

Google Ads Developers Blog · Government/Regulator

Published

22nd July 2026

Original report

ads-developers.googleblog.com

ProcIntel stores what the source published in its feed — a headline, a summary and a link. It does not store or reproduce the full article.