Google Ads API Version16 Now Out

Google released model 16 of the Google Adverts API yesterday. The replace consists of extra suggestion varieties, assist for time-related segments, assist for advertiser verification, plus far more.

This can be a main replace for the reason that final replace, model 15 again in October 2023. Then earlier than that was version 14.1 which was launched in August. Version 13.1 preceded this new model, which was launched in April 2023. Version 12.0 was launched in October 2022, Version 11.0 of the Google Adverts API was launched in June, and version 11.1 was in August. Additionally Version 10.1 was launched on April 27, 2022 and version 10.0 was launched on February 9, 2022. And Google has sunset the AdWords API on April twenty seventh which can utterly cease working on the end of July.

Here’s a launch video for model 15:

Listed below are the discharge notes for version 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 start out 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 info, which returns a number of objects of IdentityVerification. Every IdentityVerification consists of: verification_program which is the identification 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,
• Added AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT.

Belongings:

• Modifications to asset_group: Added assist for time-related segments, similar to segments.12 months and segments.month.
• Modifications to asset_group: Made marketing campaign an attributed useful resource as an alternative of segmenting useful resource.

Campaigns:

• Modifications to Demand Gen campaigns: Added assist for setting Marketing campaign.shopping_setting to an present Demand Gen marketing campaign. Added ShoppingSetting.disable_product_feed to disable the non-compulsory product feed of Demand Gen campaigns. Added Advert.demand_gen_product_ad and the corresponding DemandGenProductAdInfo, obtainable 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 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 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

Experiment:

• Added Experiment.sync_enabled to specify if sync must be enabled within the experiment. With sync enabled, adjustments made to the unique marketing campaign whereas your experiment is working, are routinely copied to the experiment marketing campaign.
• Added ExperimentError.CANNOT_ENABLE_SYNC_FOR_UNSUPPORTED_EXPERIMENT_TYPE.
• Added CampaignError.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL.

Lodge & 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 obtainable:
  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 observe 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 info they’ve added.

Planning:

• Eliminated rating from AudienceInsightsAttributeMetadata.

Suggestions:

• Added RecommendationService.GenerateRecommendations() which returns suggestions based mostly on the desired settings, similar to suggestion varieties and promoting channel varieties. That is significantly useful throughout marketing campaign building.
• Added RecommendationMetrics.conversions_value.
• Beneficial key phrases with unset key phrase match kind now have recommended_match_type set to UNSPECIFIED as an alternative 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 closing 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

Buying:

• Added CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT and CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS with the intention to present extra detailed errors for Buying campaigns linked to a Comparability Buying Service Middle account.
• Added the next values to AssetGroupListingGroupFilterError: DIMENSION_TYPE_NOT_ALLOWED, DUPLICATE_WEBPAGE_FILTER_UNDER_ASSET_GROUP, FILTER_EXCLUSION_NOT_ALLOWED, LISTING_SOURCE_NOT_ALLOWED, MULTIPLE_LISTING_SOURCES, MULTIPLE_WEBPAGE_CONDITION_TYPES_NOT_ALLOWED, MULTIPLE_WEBPAGE_TYPES_PER_ASSET_GROUP, PAGE_FEED_FILTER_HAS_PARENT

Lifecycle Targets:

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

Discussion board dialogue at X.