Google Advertisements API Model 21 Now Out

Google has launched model 21 of the Google Advertisements API, this can be a main launch with dozens of updates. Updates embrace AI Max for Search campaigns, PMax adjustments, reporting updates and far more. Google additionally made documentation updates to its Google Advertisements API assist docs.

Earlier than this launch was model 20 on June 5, 2025, 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 utterly cease working on the finish of July.

Here’s a video abstract of those adjustments:

Right here is the full change log:

AI Max for Search campaigns:

• Now you can use the ai_max_setting.enable_ai_max subject of the Marketing campaign to allow AI Max for Search campaigns. AI Max for Search campaigns expands a Search marketing campaign’s attain by means of search time period matching and permits controlling whether or not concentrating on and inventive controls serve when set. Textual content asset automation and model checklist controls that had been set in earlier model requests will nonetheless be revered till AI Max for Search campaigns is explicitly toggled and turned off. Marketing campaign.ai_max_setting.bundling_required can be utilized to find out if AI Max for Search campaigns should be enabled to respect or modify textual content asset automation and model checklist controls. AdGroup.ai_max_ad_group_setting.disable_search_term_matching can be utilized to disable search time period matching when a dad or mum marketing campaign has enabled AI Max for Search campaigns. See our weblog put up Unlock next-level efficiency with AI Max for Search campaigns.
• Added CampaignError.AI_MAX_MUST_BE_ENABLED, which is thrown for Search campaigns while you decide in to FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION with out enabling AI Max for Search campaigns on the marketing campaign.
• Added assist for making use of concentrating on controls on the advert group stage in AI Max for Search campaigns. Now you can add the next standards to advert teams: Model lists, Areas and Webpages (URL guidelines)
• Added the ai_max_search_term_ad_combination_view to report on efficiency for mixtures of search phrases, headlines, and touchdown pages. This view reveals which search queries triggered your adverts and the way these particular mixtures carried out. A future launch will embrace a further view that additionally consists of Efficiency Max knowledge. If you wish to keep away from migrating your implementation to get Efficiency Max knowledge, think about ready for that launch.
• Added AI_MAX as a brand new worth for the search_term_match_type section.

Property:

• Added the fields terms_and_conditions_text, terms_and_conditions_uri, promotion_barcode_info, and promotion_qr_code_info in PromotionAsset. Barcode and QR code fields are situated inside the promotion_trigger oneof.
• Added FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION to AssetAutomationTypeEnum. With this setting, you’ll be able to management the automated technology of textual content belongings and touchdown pages from the ultimate URL in Search campaigns.
• Added a brand new service AutomaticallyCreatedAssetRemovalService.RemoveCampaignAutomaticallyCreatedAsset to take away routinely created belongings from Marketing campaign. This service helps removing of the ultimate URL growth asset solely.
• Added DESCRIPTION_PREFIX to the ServedAssetFieldType enum. This corrects a difficulty the place the served_asset_field_type in ad_group_ad_asset_combination_view was UNKNOWN for belongings serving as an outline prefix.

Campaigns:

• Added a brand new enum worth MISSING_LOCATION_TARGETING to CampaignPrimaryStatusReason. This new standing motive will probably be returned just for location-restricted campaigns which do not specify location concentrating on. For location-restricted campaigns, any try so as to add location concentrating on exterior the allowed space will consequence within the criterion error LOCATION_TARGETING_NOT_ELIGIBLE_FOR_RESTRICTED_CAMPAIGN.
• Added assist for third-party integration companions on the VideoCustomer.third_party_integration_partners and Marketing campaign.third_party_integration_partners ranges. See the Assist Heart article Observe app conversions with third-party app analytics.
• Now you can set the advertising_partner_ids subject for an present Marketing campaign. Beforehand, this subject might solely be set for a brand new marketing campaign throughout its creation.
• Through the use of a shared checklist of sort TYPE_PLACEMENT_LIST outlined on the supervisor account stage, advertisers can now use CustomerNegativeCriterion standards to exclude a listing of placements in particular person advertiser buyer accounts.
• Added DESCRIPTION_PREFIX to the ServedAssetFieldType enum. This corrects a difficulty the place the served_asset_field_type within the ad_group_ad_asset_combination_view was UNKNOWN for belongings serving as an outline prefix.
• Added assist for the sphere target_roas_tolerance_percent_millis within the MaximizeConversionValue and TargetRoas bidding methods. TargetRoas.target_roas_tolerance_percent_millis is just out there for portfolio methods, which is just out there for Search campaigns.
• Modified a ProductGroup error code. For requests with a partial failure enabled, LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION will probably be returned as a substitute of INVALID_LISTING_GROUP_HIERARCHY.
• Added a brand new useful resource LocationInterestView that summarizes the efficiency of adgroup location curiosity standards.

Conversions:

• Added ENGAGED_VIEW as a brand new worth for the conversion_attribution_event_type section.
• Prospects will not have entry to debug_enabled mode in ConversionUploadService. This subject, if set to TRUE, was earlier used to tell apart the CLICK_NOT_FOUND error from SUCCESS for enhanced conversions for leads imports.

Demand Gen:

• Added an error code CampaignBudgetError.BUDGET_BELOW_DAILY_MINIMUM. Sooner or later, this error will probably be returned when making an attempt to set a really low finances quantity for a Demand Gen marketing campaign. Particulars concerning the required minimal finances may be discovered within the new error particulars subject budgetDailyMinimumErrorDetails.

EU political promoting adjustments:

These EU political promoting adjustments have additionally been made within the v19.2 and v20.1 releases.

• Added Marketing campaign.contains_eu_political_advertising. This subject signifies whether or not your marketing campaign accommodates political promoting content material focused in the direction of the European Union. If this subject is about to CONTAINS_EU_POLITICAL_ADVERTISING, the marketing campaign will not serve within the EU beginning September 22, 2025. API calls to create a brand new marketing campaign will fail with a FieldError.REQUIRED error if this subject will not be set. For any present campaigns, it’s best to set the contains_eu_political_advertising subject earlier than making an attempt to vary proximity, location, or location group concentrating on both on the marketing campaign or advert group ranges. The API calls to create or replace these marketing campaign or advert group standards for present campaigns will fail with a CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION error if the marketing campaign hasn’t accomplished the self-declaration. For variations v19.x and 20.x, the requirement to set this subject will not be but enforced, however will probably be sooner or later. This transformation will probably be introduced prematurely.
• Trials and Experiments will throw an ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION if the experiment’s campaigns have not self-declared whether or not they include political promoting that targets the European Union.

Efficiency Max:

• For brand new PMax campaigns the default worth of Marketing campaign.brand_guidelines_enabled is now true.
• Added the campaign_search_term_view report. This view affords search phrases metrics aggregated on the marketing campaign stage. This view additionally introduces Efficiency Max marketing campaign assist for search phrases.
• Added PERFORMANCE_MAX as a brand new worth for the search_term_match_type section.

Planning:

• Added a brand new methodology ReachPlanService.ListPlannableUserInterests, which permits advertisers to find the consumer pursuits (affinities and in-markets) supported by ReachPlanService.GenerateReachForecast. The tactic helps trying to find particular consumer curiosity varieties and querying for names and paths.
• Added AdditionalApplicationInfo to ReachPlanService.ListPlannableUserLists as an elective enter subject.
• Added assist to AudienceInsightsService.ListAudienceInsightsAttributes to fetch out there 1P consumer lists for the shopper ID making the request.
• Added 1P consumer lists assist to AudienceInsightsService.GenerateAudienceCompositionInsights to fetch insights for audiences concentrating on a consumer checklist. Any request that targets a consumer checklist will solely return the viewers index and is just out there for the next AudienceInsightsDimension: AGE_RANGE, GENDER, AFFINITY_USER_INTEREST, IN_MARKET_USER_INTEREST.
• Up to date the viewers enter sort to InsightsAudience for AudienceInsightsService.GenerateTargetingSuggestionMetrics. The brand new viewers enter permits an AND-of-ORs mixture of consumer pursuits, supporting potential attain metrics for extra personalized viewers definitions.
• Added viewers share to TrendInsightMetrics to get the share of an viewers for a development.
• Added new associated classes to KnowledgeGraphAttributeMetadata so customers can filter Data Graph Attributes by class.

Stories:

• Quite a lot of new metrics at the moment are out there for AssetGroupAsset, ChannelAggregateAssetView, and CampaignAggregateAssetView. Moreover, for ChannelAggregateAssetView and CampaignAggregateAssetView, impressions, which was beforehand zeroed out for Efficiency Max campaigns, will now report its true worth.
• Made the AssetSet useful resource selectable with ChangeStatus so customers could make get extra information concerning the AssetSet or CampaignAssetSet sort useful resource in a single question.
• Made the CampaignAssetSet useful resource selectable with ChangeStatus so customers could make get extra information concerning the AssetSet or CampaignAssetSet sort useful resource in a single question.
• Added a brand new section search_term_targeting_status that may be chosen in marketing campaign search time period view.
• Added a brand new final_url_expansion_asset_view.
• Added assist for metrics value_adjustment and all_value_adjustment within the AssetGroup report.
• Made AssetGroupAsset segmentable by ad_network_type.
• Added a brand new section landing_page_source that can be utilized with the landing_page_view useful resource.
• Added a brand new section search_term_match_source that may be chosen within the search time period and marketing campaign search time period views.
• Added a brand new section match_type that may be chosen from the key phrase view.
• Added assist for metrics for distinctive question intent clusters with
• Added a brand new click on sort VEHICLE_ASSETS within the click_view segmentation to trace and report clicks associated to the advert codecs particular to car belongings.

Video:

• Added YouTubeVideoListAsset. Additionally added Asset#youtube_video_list_asset, which can be utilized to create hyperlink between a marketing campaign and a YouTubeVideoListAsset sort. See the Assist Heart article Use associated movies.
• Added new metadata fields to YouTubeChannelInsights and YouTubeVideoAttributeMetadata.
• Uncovered new click on varieties: VIDEO_RELATED_VIDEOS_CLICK, VIDEO_CHANNEL_CLICK, and PRODUCT_ASSETS.
• Added the allow_non_skippable_in_stream subject to VideoAdInventoryControl to let Video Responsive adverts function non-skippable in-stream adverts. This feature is out there for campaigns that assist mixing the non-skippable format with different codecs.
• Added the Marketing campaign.VideoCampaignSettings.video_ad_sequence and AdGroup.VideoAdGroupSettings.VideoAdSequenceStepSetting fields (read-only). See the Assist Heart article About video advert sequencing.
• Added new metadata fields to YouTubeChannelInsights and YouTubeVideoAttributeMetadata.
• Added the VIDEO_LINEUP criterion sort and the video_lineup subject to CampaignCriterion and AdGroupCriterion. This characteristic is out there to allowlisted accounts solely. Contact your Google enterprise growth consultant for particulars.
• Added a Content material Suitability report for each the element and the group stage. See the Assist Heart article Concerning the ‘Content material suitability’ report.

Discussion board dialogue at X.