Google announced that version 11 of the Google Ads API is now available. Version 10.1 was released on April 27, 2022 and version 10.0 was released on February 9, 2022. And Google has sunset the AdWords API on April 27th which will completely stop working at the end of July.

So what is new in version 11 of the Google Ads API? Here is a short 3 minute video from Google describing the changes:

Here are the technical detail changes:

Assets

Added AssetSourceto show the source of asset or asset link for whom generated the entity. Thisis available as source in Asset,CustomerAsset,CampaignAsset, andAdGroupAsset.

Audiences

Removed DateSpecificRuleUserListInfo andRuleBasedUserListInfo.date_specific_rule_user_list.

Bidding

Renamed MaximizeConversions.target_cpa toMaximizeConversions.target_cpa_micros.MaximizeConversions.target_cpa ofAccessibleBiddingStrategyis renamed totarget_cpa_micros.

Campaigns

Smart campaigns

AddedSmartCampaignSetting.ad_optimized_business_profile_settingandAdOptimizedBusinessProfileSettingto allow Smart campaigns to use business profiles optimized for ads aslanding pages.AddedSmartCampaignSetting.business_profile_locationto accept the resource names of the Google Business Profile location toassociate with Smart campaigns.Removed SmartCampaignSetting.business_location_id, which is superseded bySmartCampaignSetting.business_profile_location.

AddedCampaign.performance_max_upgrade,whose type isPerformanceMaxUpgrade,to show the status information about a campaign being upgraded to PerformanceMax. Use the newUpgradeSmartShoppingCampaignToPerformanceMaxRecommendationto initiate the upgrade.

The search_click_sharemetric is now available for Performance Max campaigns.

For Local Servicescampaigns:

Added the ManualCpa bidding strategy andCampaign.local_services_campaign_settings,whose type isLocalServicesCampaignSettings.

You can set bids of the ManualCpa bidding strategy throughLocalServicesCampaignSettings.category_bids.

Added support for setting theMaximizeConversions bidding strategyas standard bidding strategy.

Added support for setting ad schedules as a campaigncriterion.

Conversions

Added two new fields toFirebaseSettings:

property_idproperty_name

AddedConversionAdjustmentUploadError.ORDER_ID_CONTAINS_PII.

AddedConversionUploadError.ORDER_ID_CONTAINS_PII.

RemovedConversionUploadError.EXTERNALLY_ATTRIBUTED_CONVERSION_TYPE_NOT_PERMITTED_WITH_BRAID.

Criteria

AddedSettingError.BID_ONLY_IS_NOT_ALLOWED_TO_BE_MODIFIED_WITH_CUSTOMER_MATCH_TARGETING.

Experiments

Removed ExperimentType.SMART_DISPLAY.

Planning

AddedKeywordPlanIdeaService.GenerateAdGroupThemes,which you can provide keywords and a list of ad groups. The method returnssuggested modifications (such as keyword text and match type) of the keywordsalong with the suggested ad groups in which the keywords should be placed.Added two methods toAudienceInsightsService that areavailable to allowlisted accounts only:GenerateInsightsFinderReport,used to create links to audience insight reports in InsightsFinder.ListAudienceInsightsAttributes,used to discover topics or categories for which insights are available.

Added several new fields to support co-viewing metrics in ReachForecast.

Several new fields as part ofReachForecast:

In Forecast:on_target_coview_reachtotal_coview_reachon_target_coview_impressionstotal_coview_impressions

In EffectiveFrequencyBreakdown:effective_coview_reachon_target_effective_coview_reach

In PlannedProductForecast:on_target_coview_reachtotal_coview_reachon_target_coview_impressionstotal_coview_impressions

Added ForecastMetricOption.include_coview,which is used inGenerateReachForecastRequest.forecast_metric_optionsas a flag to request the above co-view metrics to be included in theresponse.

Recommendation

AddedResponsiveSearchAdImproveAdStrengthRecommendation.

AddedUpgradeSmartShoppingCampaignToPerformanceMaxRecommendation.

Reporting

Madesegments.asset_interaction_target.assetandsegments.asset_interaction_target.interaction_on_this_assetcompatible with ad_group andcampaign.

Shopping

AddedShoppingSetting.feed_label,a more flexible way of matching campaigns with Merchant feeds. This fieldreplaces the functionality ofShoppingSetting.sales_country.Only one of these fields can be used at a time, but both fields are supported.This is available to allowlisted accounts only.

Forum discussion at Twitter.