Google has launched model 19.1 of the Google Adverts API, v19.1 added 11 new options, eliminated 0 options and adjusted 23 totally different options. This goes throughout property, campaigns, Demand Gen, conversions, LSAs, Procuring, movies and extra.
Earlier than this launch was model 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 full change log:
Property:
- Added an asset_coverage discipline for AssetGroup that returns details about gaps in your asset group. Incorporates a subfield ad_strength_action_items which returns a listing of actions that an advertiser can take to enhance the advert energy of an asset group.
Campaigns:
- Now you can price or present suggestions for leads in Native Service Campaigns. As a part of this transformation, v19.1: Added a brand new service named LocalServicesLeadService. You need to use the ProvideLeadFeedback technique to add score and suggestions for leads. Added a brand new discipline named lead_feedback_submitted to LocalServicesLead to assist decide if suggestions was submitted to a lead.
- Added a brand new metric column biddable_cohort_app_ post_install_conversions for App campaigns.
Demand Gen:
- Further strategies had been launched within the Planning companies to assist Demand Gen.
- Added assist for AdGroup-level Channel Controls for Demand Gen campaigns. You possibly can choose a predefined normal grouping of channels, or a subset of channels utilizing the demand_gen_ad_group_settings discipline. The next channels are supported within the present launch: YouTube In-Stream, YouTube In-Feed, YouTube Shorts, Uncover, Gmail, Show
- Uncovered a brand new asset sort for TALL_PORTRAIT_MARKETING_IMAGE. This asset sort pertains to the tall_portrait_marketing_images discipline of the Demand Gen Multi Asset Advert format.
Change Historical past:
- Added assist for 3 extra useful resource varieties into ChangeStatusResourceType: CAMPAIGN_BUDGET, ASSET_SET, CAMPAIGN_ASSET_SET
- You possibly can retrieve these three finer-grained varieties from the change_status report.
Conversions:
- Now you can set the google_ads_conversion_customer discipline whereas creating a brand new buyer utilizing the Google Adverts API. This was beforehand a read-only discipline.
- Now you can specify the kind of the shopper related to the conversion when importing offline conversions.
- A brand new session_attributes discipline was launched for ClickConversion.
Native Providers Adverts:
- Added a brand new RPC ProvideLeadFeedback to LocalServicesLeadService to supply suggestions on the standard of LocalServicesLead.
- Added a brand new discipline lead_feedback_submitted to the LocalServicesLead useful resource that confirms if suggestions was offered for a selected useful resource.
Planning companies:
- Added assist for Goal frequency month-to-month forecasts in ReachPlanService.GenerateReachForecast.
Builders can set TargetFrequencyTimeUnit.MONTHLY in TargetFrequencySettings when utilizing the TARGET_FREQUENCY plannable product code to generate a Goal frequency month-to-month attain forecast. - Added a brand new technique ReachPlanService.GenerateConversionRates, which permits advertisers to request urged conversion charges for supported plannable merchandise.
- Demand Gen forecasting in ReachPlanService.GenerateReachForecast: Builders can now request attain forecasts for Demand Gen campaigns. Builders can use the brand new DEMAND_GEN_MAX_CONVERSIONS plannable product code to generate Demand Gen attain forecasts. Added a brand new conversion_rate discipline that enables builders requesting Demand Gen attain forecasts to supply a conversion price. Instructed conversion charges may be retrieved utilizing the brand new ReachPlanService.GenerateConversionRates technique. This discipline is required for Demand Gen forecasting requests. It’s not supported for different plannable merchandise. Added a brand new conversions discipline to returned forecasts. This discipline accommodates the variety of conversions at a given level on the attain curve. Conversions are solely supported for the DEMAND_GEN_MAX_CONVERSIONS plannable product.
Suggestions:
- The brand new ad_strength discipline is accessible for ImprovePerformanceMaxAdStrengthRecommendation, which returns the present advert energy rating of the asset group related to the advice.
Procuring:
- Now you can override model exclusions for Procuring adverts in Efficiency Max campaigns. That is uncovered by a brand new pmax_campaign_settings discipline on the marketing campaign degree, and it really works just for PMax campaigns for Retail. A brand new CampaignError.BRAND_TARGETING_OVERRIDES_NOT_SUPPORTED error can be thrown for those who try to set this discipline for an incompatible marketing campaign sort.
Movies:
- Added read-only assist for Audio Adverts. See Google Adverts Assist Heart to study this characteristic. This modifications exposes: A brand new AdvertisingChannelSubType named YOUTUBE_AUDIO. A brand new AdGroupType named YOUTUBE_AUDIO. A brand new advert format enumeration named YOUTUBE_AUDIO_AD, and its corresponding YouTubeAudioAdInfo fields.
- Added new metrics and segments to question attain metrics with demo adjustment. As a part of these modifications, Two new metrics columns named coviewed_impressions and primary_impressions had been launched. Two new segments named adjusted_age_range and adjusted_gender had been launched. If both of the 2 new segments are chosen alongside a attain metric discipline (coviewed_impressions, primary_impressions, unique_users, or average_impression_frequency_per_user), the opposite phase have to be chosen as nicely to retrieve legitimate stats for these columns. This characteristic is presently obtainable just for allowlisted prospects.
Discussion board dialogue at X.
