Introduction to the Google Ads API v23.2 Release
In the rapidly evolving landscape of digital advertising, the ability to automate, scale, and gain granular insights into campaign performance is what separates market leaders from the rest. Google has recently announced the release of version 23.2 of the Google Ads API, marking another incremental but significant step in the platform’s journey toward more transparent and automated advertising solutions. This update is particularly relevant for developers, data scientists, and agency reporting teams who rely on the API to manage complex accounts and build proprietary tools.
While some API updates focus on broad architectural changes, v23.2 targets specific “blind spots” that have persisted in the Google Ads ecosystem—most notably within Performance Max and App campaigns. By introducing new resources like VideoEnhancement and AppTopCombinationView, Google is providing the programmatic community with the data necessary to evaluate the efficacy of AI-driven creative elements. As the industry moves further into an AI-first era, these technical bridges allow advertisers to maintain a degree of human oversight over machine-generated outputs.
Enhancing Transparency in Video Creative with VideoEnhancement
One of the most discussed updates in the v23.2 release is the introduction of the VideoEnhancement resource. For years, one of the primary critiques of Performance Max (PMax) and other automated campaign types has been the “black box” nature of creative assets. Google often takes existing images, text, and video clips provided by an advertiser and uses generative AI or automated editing tools to create new video assets. While this helps fill inventory gaps, advertisers often struggle to report on whether a specific impression was served using their hand-crafted video or a Google-generated version.
Understanding Advertiser-Provided vs. Google-Generated Content
The VideoEnhancement resource now surfaces whether a video ad is Google-generated or advertiser-provided. This is a vital distinction for brand-conscious organizations. Many high-end brands have strict creative guidelines and want to ensure that their message is conveyed exactly as designed. With this new API functionality, developers can build reporting dashboards that explicitly flag AI-enhanced videos.
By programmatically identifying these assets, agencies can now answer critical questions: Are Google-generated videos outperforming original assets? Do auto-enhanced videos maintain the brand’s aesthetic standards? This level of visibility allows for a more nuanced conversation between media buyers and creative teams, as they can now quantify the value of automated video generation within the Google ecosystem.
Implications for Performance Max Reporting
Performance Max has often been criticized for its lack of granular reporting compared to traditional Search or Display campaigns. The addition of VideoEnhancement data to the API is a direct response to the demand for more clarity. It allows for a more sophisticated analysis of the “asset group” performance, giving users the power to see exactly which components are being manipulated by Google’s algorithms to drive conversions.
Optimizing Mobile Growth with AppTopCombinationView
Mobile app marketing continues to be a massive vertical for Google, and v23.2 introduces a new tool for those managing App campaigns: the AppTopCombinationView resource. This new resource provides read-only insights into the top-performing asset combinations within App campaigns.
App campaigns are notoriously automated, with Google’s machine learning deciding which combination of headlines, descriptions, images, and videos will resonate most with a specific user segment. Historically, getting a clear view of which specific “recipe” of assets was winning the most auctions was difficult to extract via the API.
Leveraging Asset Combinations for Creative Strategy
With AppTopCombinationView, developers can now programmatically retrieve the winning combinations. While the resource is read-only—meaning you cannot change the combinations directly through this specific view—the data it provides is invaluable for informing future creative production. If the data shows that a specific short-form video paired with a “Play Now” call-to-action is consistently the top performer, creative teams can lean into that style for their next set of assets.
This update bridges the gap between raw performance data and actionable creative strategy. By pulling this data into third-party visualization tools, app marketers can provide stakeholders with a clear visual representation of what their most successful ads actually look like to the end user.
New Control Settings for Demand Gen Campaigns
Demand Gen campaigns, which replaced Discovery campaigns, are designed to capture user interest across YouTube (including Shorts), Discover, and Gmail. For travel and hospitality advertisers, Google has included a specific update in v23.2: the ability to disable the hotel feed via the HotelSettingInfo.disable_hotel_setting field.
Granular Control for Travel Advertisers
In previous iterations, managing how hotel feeds interacted with Demand Gen campaigns could be cumbersome. There are scenarios where a travel brand might want to run a broad brand awareness campaign using Demand Gen without necessarily pulling in the dynamic price-and-inventory feed from their hotel center. By providing a programmatic toggle to disable this setting, Google is giving developers more control over how specialized data feeds are utilized in cross-channel campaigns.
This change reflects a broader trend in the Google Ads API: providing “opt-out” mechanisms for automated features that may not align with every advertiser’s specific strategy. It allows for a more tailored approach to campaign architecture, ensuring that the automation serves the advertiser’s goals rather than the other way around.
Expanding Conversion Metrics: Indirect First In-App Installs
Measurement remains the cornerstone of digital advertising, and v23.2 introduces a new metric that addresses the complexities of the modern app ecosystem. The API now supports a conversion metric for “indirect first in-app installs” across Campaign, Customer, and AdGroup resources.
Navigating the Attribution Challenge
In the world of mobile apps, attribution is rarely a straight line. Users may interact with multiple ads, visit a website, and eventually download an app through a path that isn’t a direct “click-to-install.” The indirect first in-app install metric helps capture these more complex conversion paths.
For high-volume app advertisers, this metric is crucial for understanding the holistic impact of their ad spend. It allows for a better understanding of how Top-of-Funnel (TOFU) awareness campaigns contribute to eventual app downloads, even if those downloads aren’t immediately attributed to a direct ad click. By integrating this into the API, Google allows developers to build more comprehensive attribution models that account for the nuances of user behavior on mobile devices.
Enhancements to Insights and Planning Services
The v23.2 release also brings several refinements to the ContentCreatorInsightsService and the ReachPlanService. These services are vital for the “pre-flight” phase of advertising—where planners determine where to allocate budget and which creators to partner with.
ContentCreatorInsightsService and the Creator Economy
As YouTube continues to lean into the creator economy, the ContentCreatorInsightsService becomes a more central tool for advertisers. This service helps brands identify creators whose audience demographics align with their target market. The enhancements in v23.2 likely focus on the speed and accuracy of these insights, allowing for more dynamic planning in a fast-moving content environment.
ReachPlanService Improvements
The ReachPlanService is the programmatic engine behind media planning. It allows advertisers to forecast the potential reach and frequency of their campaigns across various formats. The updates in this version are designed to make these forecasts more accurate, particularly as more inventory types (like YouTube Shorts) become standard parts of a media mix. For developers building media planning tools, these refinements ensure that the projections provided to clients are as close to reality as possible.
Technical Implementation: How to Upgrade to v23.2
For development teams, the release of a new API version necessitates a structured upgrade path. Google has confirmed that v23.2 is now the current stable version, and the transition involves several key steps.
Updating Client Libraries and Code
To take advantage of the new resources and metrics, developers must update their client libraries. Google maintains libraries for several popular programming languages, including Java, PHP, Python, Ruby, Perl, and .NET. All of these updated libraries, along with updated code examples, have already been published to the official Google Ads Developer site.
The upgrade process generally involves:
1. Updating the library dependency in your project configuration (e.g., updating your Maven or Composer file).
2. Reviewing the release notes for any breaking changes or deprecated fields that may affect your existing integration.
3. Implementing the new resource calls, such as the VideoEnhancement or AppTopCombinationView, where applicable.
4. Testing the updated code in a test environment before deploying to production.
Live Walkthrough and Support
To assist with the transition, Google is hosting a live release walkthrough. This event is scheduled for March 26 at 11:00 AM ET. The walkthrough will be broadcast across Discord and YouTube Live, providing a forum for developers to ask questions and see the new features in action. For those unable to attend the live session, a recorded version will be made available shortly after the broadcast. This proactive support from Google’s developer relations team is a testament to the importance they place on the API community.
The Strategic Significance of the v23.2 Update
While some may view API updates as purely technical maintenance, version 23.2 signals where Google is focusing its energy. The emphasis on video enhancement and app combinations shows that Google is listening to feedback regarding the “transparency gap” in AI-driven advertising.
For agencies, this update is a powerful selling point. They can now offer their clients deeper insights into how their creative assets are being utilized by Google’s AI. They can demonstrate a higher level of control over Demand Gen campaigns and provide more accurate attribution for app installs. In a market where every dollar of ad spend is scrutinized, the ability to provide this level of detail is a competitive advantage.
Preparing for a Data-Driven Future
The transition to v23.2 should be seen as part of a larger strategy to embrace data-driven decision-making. As privacy regulations continue to evolve and third-party cookies phase out, the first-party data provided through the Google Ads API becomes even more critical. The new metrics and resources provided in this update are designed to work within this new privacy-first reality, offering insights that don’t rely on intrusive tracking but rather on the direct performance of assets within Google’s own ecosystem.
Conclusion: Moving Forward with Google Ads API v23.2
The release of v23.2 of the Google Ads API is a routine but highly useful update that addresses several high-priority needs for modern advertisers. By focusing on creative transparency, mobile app performance, and granular campaign controls, Google is empowering developers to build more effective and transparent advertising tools.
The addition of the VideoEnhancement resource is perhaps the most significant “win” for those looking to demystify Performance Max, while the AppTopCombinationView provides a much-needed window into the mechanics of App campaigns. As advertisers prepare for the live walkthrough on March 26, now is the time for technical teams to begin reviewing their code and planning their upgrade paths.
By staying current with the latest API versions, organizations ensure they have access to the most accurate data and the most powerful automation features available. In the world of digital advertising, staying ahead of the curve is not just an advantage—it is a necessity. Version 23.2 provides the tools necessary to maintain that edge, offering a clearer view of the road ahead in an increasingly automated world.