Google has launched model 20 of the Google Advertisements API, it is a main launch, and we predict two extra main releases in 2025. Google up to date its API launch schedule replace, there may be new Demand Gen ad_network_type reporting, Platform comparable conversions and Marketing campaign-level damaging key phrases for PMax – plus extra.
Google wrote:
Right this moment, we’re asserting the v20 launch of the Google Advertisements API. To make use of among the v20 options, you will need to improve your shopper libraries and shopper code. The up to date shopper libraries and code examples might be printed subsequent week.
Earlier than this launch was model 19.1 in April 2025, then 19 in February 2025, then model 18 in October 2024. Earlier than that was 17.1 in August 2024 after which earlier than that was model 17.0 in June 2024 after which earlier than that was model 16.1 after which Model 16 in February 2024. Earlier than that was model 15 again in October 2023. Then earlier than that was model 14.1 which was launched in August. Model 13.1 preceded this new model, which was launched in April 2023. Model 12.0 was launched in October 2022, Model 11.0 of the Google Advertisements API was launched in June, and model 11.1 was in August. Additionally Model 10.1 was launched on April 27, 2022 and model 10.0 was launched on February 9, 2022. And Google has sundown the AdWords API on April twenty seventh which can fully cease working on the finish of July.
Right here is the discharge schedule:
Here’s a video abstract of those modifications:
Right here is the full change log:
Property:
- Added a number of new metrics and section columns for the asset_group report.
- New metrics columns
- New Phase columns
Campaigns:
- Added help for including and updating campaign-level damaging key phrases for Efficiency Max campaigns.
Conversions:
- Now you can replace the google_ads_conversion_customer subject on an current buyer to choose in to cross-account conversion monitoring, or to alter its current conversion monitoring guardian to a special supervisor account.
- Added the ClickConversion.user_ip_address subject. Google Advertisements doesn’t help IP tackle matching for finish customers within the European Financial Space (EEA), United Kingdom (UK), or Switzerland (CH). Please add logic to conditionally exclude sharing IP addresses from customers from these areas. Just remember to present customers with clear and complete details about the information you acquire in your websites, apps, and different properties and get consent the place required by regulation or any relevant Google insurance policies. See the About offline conversion imports web page for extra particulars.
Demand Gen:
- Added new values to the ad_network_type section that permit segmenting Demand Gen campaigns by channel: MAPS, GMAIL, DISCOVER
- Added metrics for platform-comparable conversions
Suggestions:
- Added the merchant_id subject to GenerateRecommendationsRequest to point when suggestions must be generated for retail, fairly than the usual Efficiency Max campaigns.
Planning:
- Added AudienceInsightsDimension.YOUTUBE_LINEUP to interchange AudienceInsightsDimension.YOUTUBE_DYNAMIC_LINEUP in AudienceInsightsService and ContentCreatorInsightsService. This new dimension permits you to retrieve insights and metadata for YouTube Choose (YTS) Lineups. Changed objects related to YOUTUBE_DYNAMIC_LINEUP akin to DynamicLineupAttributeMetadata and the AudienceInsightsDynamicLineup to align with the broader removing of Dynamic Lineups throughout Google Advertisements. This function is simply obtainable to accounts on an allowlist.
- Added AdditionalApplicationInfo and ApplicationInstance within the AudienceInsightsService, ContentCreatorInsightsService, and ReachPlanService. This function is simply obtainable to accounts on an allowlist.
- Up to date AudienceInsightsService and ContentCreatorInsightsService to supply extra detailed insights. Now you can section content material creator information by system utilizing the brand new AudienceInsightsDimension.DEVICE and AudienceInsightsAttribute.system in each providers. This function is simply obtainable to accounts on an allowlist.
- Added further aggregated video metrics to GenerateCreatorInsightsResponse for extra complete content material creator evaluation: engagement_rate, average_views_per_video, average_likes_per_video, average_shares_per_video, average_comments_per_video, shorts_views_count, shorts_video_count, and is_brand_connect_creator. This function is simply obtainable to accounts on an allowlist.
- Added sub_country_locations to GenerateCreatorInsightsRequest for the ContentCreatorInsightsService. This permits specifying sub-country geographic areas to refine searches for creator insights. The sub_country_locations subject is simply supported when utilizing the search_attributes oneof within the standards subject. If sub_country_locations are supplied with different standards sorts, the request might be invalid. This allows extra granular geographical focusing on and evaluation for content material creator insights. This function is simply obtainable to accounts on an allowlist.
- Added ReachPlanService.ListPlannableUserLists, which returns first-party consumer lists owned by a buyer, and added UserListInfo to the viewers focusing on choices in GenerateReachForecastRequest. This allows you to retrieve plannable consumer lists for a given buyer after which generate attain forecasts for campaigns focusing on these particular audiences. These enhancements enhance tailor-made attain planning by incorporating your first-party viewers information instantly into forecasting. Attain forecasting is out there to allowlisted accounts solely.
Movies:
- Added AdFormatType.PAUSE advertisements served on natural YouTube movies on TV screens, which is included in reporting. These advertisements are displayed instantly subsequent to the static video body on the pause display. This doesn’t embody Demand Gen video advertisements displayed on the advert panel under or on high of a paused natural video, that are reported underneath AdFormatType.INFEED.
Discussion board dialogue at X.
