Google Adverts API Model 20 Now Out

Google has launched model 20 of the Google Adverts API, this can be 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 unfavourable key phrases for PMax – plus extra.

Google wrote:

As we speak, we’re saying the v20 launch of the Google Adverts API. To make use of among the v20 options, you have to improve your shopper libraries and shopper code. The up to date shopper libraries and code examples can 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 Adverts 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 is able to utterly cease working on the finish of July.

Right here is the discharge schedule:

Here’s a video abstract of those adjustments:

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 Section columns

Campaigns:

• Added assist for including and updating campaign-level unfavourable key phrases for Efficiency Max campaigns.

Conversions:

• Now you can replace the google_ads_conversion_customer discipline on an current buyer to decide 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 discipline. Google Adverts doesn’t assist IP handle 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 legislation 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 discipline to GenerateRecommendationsRequest to point when suggestions ought to be generated for retail, somewhat than the usual Efficiency Max campaigns.

Planning:

• Added AudienceInsightsDimension.YOUTUBE_LINEUP to exchange 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 corresponding to DynamicLineupAttributeMetadata and the AudienceInsightsDynamicLineup to align with the broader elimination of Dynamic Lineups throughout Google Adverts. This characteristic is just accessible to accounts on an allowlist.
• Added AdditionalApplicationInfo and ApplicationInstance within the AudienceInsightsService, ContentCreatorInsightsService, and ReachPlanService. This characteristic is just accessible to accounts on an allowlist.
• Up to date AudienceInsightsService and ContentCreatorInsightsService to supply extra detailed insights. Now you can section content material creator knowledge by machine utilizing the brand new AudienceInsightsDimension.DEVICE and AudienceInsightsAttribute.machine in each companies. This characteristic is just accessible to accounts on an allowlist.
• Added extra 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 characteristic is just accessible to accounts on an allowlist.
• Added sub_country_locations to GenerateCreatorInsightsRequest for the ContentCreatorInsightsService. This enables specifying sub-country geographic areas to refine searches for creator insights. The sub_country_locations discipline is just supported when utilizing the search_attributes oneof within the standards discipline. If sub_country_locations are supplied with different standards varieties, the request can be invalid. This allows extra granular geographical concentrating on and evaluation for content material creator insights. This characteristic is just accessible to accounts on an allowlist.
• Added ReachPlanService.ListPlannableUserLists, which returns first-party person lists owned by a buyer, and added UserListInfo to the viewers concentrating on choices in GenerateReachForecastRequest. This allows you to retrieve plannable person lists for a given buyer after which generate attain forecasts for campaigns concentrating on these particular audiences. These enhancements enhance tailor-made attain planning by incorporating your first-party viewers knowledge immediately into forecasting. Attain forecasting is accessible 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 immediately subsequent to the static video body on the pause display. This doesn’t embody Demand Gen video advertisements displayed on the advert panel beneath or on prime of a paused natural video, that are reported underneath AdFormatType.INFEED.

Discussion board dialogue at X.