Google released model 16 of the Google Adverts API yesterday. The replace consists of extra advice sorts, 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 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 here 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 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 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 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 client 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.
Property:
- Adjustments to asset_group: Added assist for time-related segments, comparable to segments.12 months and segments.month.
- Adjustments to asset_group: Made marketing campaign an attributed useful resource as an alternative of segmenting useful resource.
Campaigns:
- Adjustments 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 elective 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 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 operating, 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 out there:
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 Providers:
- 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 primarily based on the desired settings, comparable to advice sorts and promoting channel sorts. That is significantly useful throughout marketing campaign development.
- Added RecommendationMetrics.conversions_value.
- Really useful key phrases with unset key phrase match kind now have recommended_match_type set to UNSPECIFIED as an alternative of UNKNOWN.
- Added the next kinds 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 remaining URL enlargement to 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 degree and IMPROVE_DEMAND_GEN_AD_STRENGTH which recommends bettering 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 with a view 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 sorts in line with different operation sorts within the API.
Discussion board dialogue at X.
