Google Advertisements API Version16 Now Out

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

It is 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 is able to utterly cease working on the finish of July.

Here’s a launch video for model 15:

Listed below 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 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 data, which returns a number of objects of IdentityVerification. Every IdentityVerification consists of: verification_program which is the id verification program sort, identity_verification_requirement that comprises particulars associated to the deadline by which the advertiser ought to end verification
  verification_progress that comprises 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, resembling segments.12 months and segments.month.
• Modifications to asset_group: Made marketing campaign an attributed useful resource as a substitute 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 optionally available product feed of Demand Gen campaigns. Added Advert.demand_gen_product_ad and the corresponding DemandGenProductAdInfo, accessible 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 reason 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 reason 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 needs to 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.

Resort & Journey:

• Added the next fields to ListingDimensionInfo for a Issues to do advert to allow creating itemizing teams primarily based on the state and metropolis the place the journey exercise is offered:
  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 data they’ve added.

Planning:

• Eliminated rating from AudienceInsightsAttributeMetadata.

Suggestions:

• Added RecommendationService.GenerateRecommendations() which returns suggestions primarily based on the required settings, resembling advice varieties and promoting channel varieties. That is significantly useful throughout marketing campaign building.
• Added RecommendationMetrics.conversions_value.
• Really helpful key phrases with unset key phrase match sort now have recommended_match_type set to UNSPECIFIED as a substitute of UNKNOWN.
• Added the next sorts 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 checklist 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 stage and IMPROVE_DEMAND_GEN_AD_STRENGTH which recommends enhancing advert energy on Demand Gen campaigns

Purchasing:

• 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 Purchasing campaigns linked to a Comparability Purchasing Service Heart 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.