Google Adverts API Model 13.0 Now Out

Google has launched Google Adverts API model 13.0 and under is an inventory of what modified. The massive modifications embody Efficiency max for journey objectives and remarketing with rule-based person lists however there are tons of modifications in model 13.

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 can fully cease working on the finish of July.

Google revealed a video of the main modifications in 13.0:

Right here is the complete checklist of modifications:

Account Administration

• Added ProductLinkService to assist including and eradicating a hyperlink between a Google Adverts account and one other product. That is much like the Linked accounts view within the Google Adverts UI. On this model, solely Buyer Match knowledge companion linking is supported.

Property

• Added the next fields to Buyer to trace the migration standing of location and picture belongings: location_asset_auto_migration_done, image_asset_auto_migration_done, location_asset_auto_migration_done_time, image_asset_auto_migration_done_time.
• Added the next fields to CustomerAsset, CampaignAsset, AdGroupAsset: primary_status, primary_status_details, primary_status_reasons
• Added Asset.field_type_policy_summaries to return details about coverage summaries for every subject sort.
• Asset subject varieties; Added AssetFieldType.BUSINESS_LOGO., Added assist for setting CampaignAsset.field_type to the next values: AssetFieldType.BUSINESS_NAME, AssetFieldType.BUSINESS_LOGO
• Added INVALID_EXCLUDED_PARENT_ASSET_SET_TYPE to, AdGroupError, CampaignError
• Added the next fields to AssetSetError: OAUTH_INFO_INVALID, OAUTH_INFO_MISSING, CANNOT_DELETE_AS_ENABLED_LINKAGES_EXIST

Audiences

• Eliminated CombinedRuleUserListInfo and ExpressionRuleUserListInfo and their references from RuleBasedUserListInfo. Use FlexibleUserListInfo as an alternative.
• Added QualifyingQuestion and qualifying_question to assist returning particulars about qualifying questions of lead kind belongings. When advertisers recommend a qualifying query, it will be reviewed and accepted earlier than getting used within the lead types.

Batch Jobs

• Added BatchJobMetadata.execution_limit_seconds to return the restrict of execution in seconds. Batch jobs will likely be canceled if their execution time is longer than specified on this subject.

Billing

• Added InvalidActivitySummary to permit for returning extra particulars in regards to the invalid exercise for the bill.
• Added AccountBudgetProposalError.CANCELED_BILLING_SETUP.

Campaigns

• Added SmartCampaignSettingService.GetSmartCampaignStatus for retrieving a extra aggregated view of belongings belonging to the Good marketing campaign. This ought to be most popular over different standing fields—for instance, Marketing campaign.primary_status or Marketing campaign.primary_status_reasons for Good campaigns.
• Changed AdGroup.explorer_auto_optimizer_setting with AdGroup.optimized_targeting_enabled to assist optimized concentrating on. That is for the next AdvertisingChannelType: DISPLAY, VIDEO, DISCOVERY. This subject is for allowlisted clients solely.
• Added a number of new enum values to CampaignError: AVERAGE_DAILY_SPEND_TOO_HIGH, CANNOT_ATTACH_TO_REMOVED_CAMPAIGN_GROUP, CANNOT_ATTACH_TO_BIDDING_STRATEGY, CANNOT_CHANGE_BUDGET_PERIOD
  CANNOT_CREATE_DRAFT_CAMPAIGN, CANNOT_CREATE_MORE_THAN_ONE_DRAFT_CAMPAIGN, NOT_ENOUGH_CONVERSIONS
  CANNOT_SET_MORE_THAN_ONE_CONVERSION_ACTION, NOT_COMPATIBLE_WITH_BUDGET_TYPE, NOT_COMPATIBLE_WITH_UPLOAD_CLICKS_CONVERSION, TRIAL_MUST_USE_SAME_BUDGET_AS_BASE, INVALID_EXCLUDED_PARENT_ASSET_SET_TYPE

Conversions

• ConversionUploadError.CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS will likely be returned in case you add a ClickConversion with user_identifiers set utilizing ConversionUploadService.UploadClickConversion, however haven’t accepted the client knowledge phrases.
• ConversionUploadError.CLICK_CONVERSION_ALREADY_EXISTS will likely be returned in case you attempt to add the identical mixture of gbraid, conversion_action, and conversion_date_time on completely different days.
• ConversionUploadError.CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS will likely be returned if you have not adopted the setup directions earlier than utilizing enhanced conversions for leads.
• Added ConversionActionType.WEBPAGE_CODELESS to signify conversions created from web site occasions.

Standards

• Added CampaignCriterion.local_service_id and LocalServiceIdInfo to permit for including and eradicating providers an advertiser serves to a Native Companies Marketing campaign.
• CampaignCriterionError.AT_LEAST_ONE_LOCAL_SERVICE_ID_CRITERION_REQUIRED_FOR_LOCAL_SERVICES_CAMPAIGN will likely be returned in case you try to take away the final marketing campaign criterion that incorporates local_service_id from a Native Companies Marketing campaign.
• CampaignCriterionError.LOCAL_SERVICE_ID_NOT_FOUND_FOR_CATEGORY will likely be returned in case you try so as to add a marketing campaign criterion that incorporates local_service_id that’s invalid for the class of your Native Service marketing campaign. You will get details about the class by fetching marketing campaign.local_services_campaign_settings.category_bids.

Errors

• Beginning in v13, the error codes returned for some invalid operations have modified for the next fields.

Resort & Journey

• Added assist for Efficiency Max for journey objectives with the next new fields, assets, and enums: Fields Marketing campaign.hotel_property_asset_set, AssetSet.hotel_property_data and HotelPropertyData, Asset.hotel_property_asset and HotelPropertyAsset. Enums: Added HOTEL_PROPERTY to:
  AssetSetType, AssetType, AssetFieldType, AssetGroupAssetError.HOTEL_PROPERTY_ASSET_NOT_LINKED_TO_CAMPAIGN, CampaignError.ASSET_SET_NOT_A_HOTEL_PROPERTY_ASSET_SET, CampaignError.HOTEL_PROPERTY_ASSET_SET_ONLY_FOR_PERFORMANCE_MAX_FOR_TRAVEL_GOALS
• Closed allowlisted clients solely: Added TravelAssetSuggestionService to recommend required photographs and textual content belongings (akin to headlines, descriptions, lengthy descriptions) for use to create asset teams in Efficiency Max for journey objective campaigns.
• Allowlisted clients solely: Added assist for Issues to do advertisements campaigns by including the next new fields, assets, and enums: Fields, Enums, For marketing campaign creation, For advert group creation,
  Errors, Studies, travel_performance_view, travel_activity_group_view

Suggestions

• The next feed-based suggestions are changed with asset-based suggestions:
  Suggestion.call_extension_recommendation changed by Suggestion.call_asset_recommendation
  Suggestion.callout_extension_recommendation changed by Suggestion.callout_asset_recommendation
  Suggestion.sitelink_extension_recommendation changed by Suggestion.sitelink_asset_recommendation
• Added Suggestion.campaigns to point out the campaigns focused by the advice.
  Eliminated ResponsiveSearchAdAssetRecommendation.current_ad.

Procuring

• Eliminated ProductBiddingCategoryInfo.country_code.
• Added assist for segments.product_feed_label in shopping_performance_view.

Video

• Eliminated PreferredContentInfo and its reference from AdGroupBidModifier.
• Added call-to-action fields for video bumper advertisements: VideoBumperInStreamAdInfo.action_button_label, VideoBumperInStreamAdInfo.action_headline
• Added TargetCpm.target_frequency_goal and TargetCpmTargetFrequencyGoal to assist offering further particulars in regards to the objective of the Goal CPM bidding technique.
• Added AdvertisingChannelSubType.VIDEO_REACH_TARGET_FREQUENCY.
• Added PlacementType.GOOGLE_PRODUCTS.

Discussion board dialogue at Twitter.