Google Advertisements API Version16 Now Out


Google Ads Api Pipes

Google launched model 16 of the Google Advertisements API yesterday. The replace contains extra suggestion varieties, assist for time-related segments, assist for advertiser verification, plus way more.

This can be a main replace for the reason that final replace, 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.

Here’s a launch video for model 15:

Listed here are the discharge notes for model 16:

Account Administration:

  • Migrated advertising_partner from AccountLink to ProductLink and ProductLinkInvitation.
  • Eliminated data_partner and google_ads from AccountLink.
  • Added IdentityVerificationService to handle advertiser verification. StartIdentityVerification() is used to begin a verification session utilizing the offered verification_program. It creates a brand new verification session and returns an empty response for a efficiently created verification. Added IdentityVerificationProgram.ADVERTISER_IDENTITY_VERIFICATION. GetIdentityVerification() can be utilized for retrieving verification data, which returns a number of objects of IdentityVerification. Every IdentityVerification contains: verification_program which is the id verification program kind, identity_verification_requirement that incorporates particulars associated to the deadline by which the advertiser ought to end verification
    verification_progress that incorporates particulars associated to the verification session together with:
    program_status represents the present standing of this verification session
    action_url directs the shopper to a URL to finish the verification. invitation_link_expiration_time represents the expiration date for the action_url; Enums:
    IdentityVerificationProgram, IdentityVerificationProgramStatus; Errors: IdentityVerificationError,


  • Modifications to asset_group: Added assist for time-related segments, equivalent to segments.yr and segments.month.
  • Modifications to asset_group: Made marketing campaign an attributed useful resource as a substitute of segmenting useful resource.


  • Modifications to Demand Gen campaigns: Added assist for setting Marketing campaign.shopping_setting to an current Demand Gen marketing campaign. Added ShoppingSetting.disable_product_feed to disable the optionally available product feed of Demand Gen campaigns. Added Advert.demand_gen_product_ad and the corresponding DemandGenProductAdInfo, out there to Demand Gen campaigns with a non-null Marketing campaign.shopping_setting.
  • Added to following fields to AdGroup to indicate whether or not the advert group is serving or the explanation why it is not serving: primary_status and primary_status_reasons
  • Added to following fields to AdGroupAd to indicate whether or not the advert group advert is serving or the explanation why it is not serving: primary_status, primary_status_reasons
  • Added the next values to AdGroupError: CANNOT_ADD_AD_GROUP_FOR_CAMPAIGN_TYPE and INVALID_STATUS


  • Added Experiment.sync_enabled to specify if sync needs to be enabled within the experiment. With sync enabled, adjustments made to the unique marketing campaign whereas your experiment is operating, are robotically copied to the experiment marketing campaign.

Resort & Journey:

  • Added the next fields to ListingDimensionInfo for a Issues to do advert to allow creating itemizing teams based mostly on the state and metropolis the place the journey exercise is accessible:
    activity_state and activity_city
  • Added assist for the next segments to travel_activity_performance_view: segments.activity_city, segments.activity_country and segments.activity_state

Native Companies:

  • Added LocalServicesVerificationArtifact.business_registration_check_verification_artifact and BusinessRegistrationCheckArtifact to permit advertisers to watch the progress of the enterprise registration verification course of.
  • Added a brand new useful resource local_services_employee to permit advertisers to retrieve the worker data they’ve added.


  • Eliminated rating from AudienceInsightsAttributeMetadata.


  • Added RecommendationService.GenerateRecommendations() which returns suggestions based mostly on the required settings, equivalent to suggestion varieties and promoting channel varieties. That is significantly useful throughout marketing campaign development.
  • Added RecommendationMetrics.conversions_value.
  • Really helpful key phrases with unset key phrase match kind now have recommended_match_type set to UNSPECIFIED as a substitute of UNKNOWN.
  • Added the next forms of suggestions: MAXIMIZE_CONVERSION_VALUE_OPT_IN which recommends opting in to the Maximize conversion worth bidding technique and IMPROVE_GOOGLE_TAG_COVERAGE which recommends deploying Google Tag on extra pages
    PERFORMANCE_MAX_FINAL_URL_OPT_IN which recommends turning on last URL enlargement in your Efficiency Max campaigns and REFRESH_CUSTOMER_MATCH_LIST which recommends updating a buyer listing that hasn’t been up to date within the final 90 days and CUSTOM_AUDIENCE_OPT_IN which recommends making a customized viewers and LEAD_FORM_ASSET which recommends including lead type belongings on the marketing campaign or buyer degree and IMPROVE_DEMAND_GEN_AD_STRENGTH which recommends bettering advert power on Demand Gen campaigns


  • Added CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT and CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS to be able to present extra detailed errors for Buying campaigns linked to a Comparability Buying Service Heart account.

Lifecycle Objectives:

  • Added replace to CustomerLifecycleGoalOperation and CampaignLifecycleGoalOperation to make these operation varieties per different operation varieties within the API.

Discussion board dialogue at X.


Please enter your comment!
Please enter your name here