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 large adjustments embrace Efficiency max for journey objectives and remarketing with rule-based consumer lists however there are tons of adjustments 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 is able to fully cease working on the finish of July.

Google revealed a video of the foremost adjustments in 13.0:

Right here is the total checklist of adjustments:

Account Administration

• Added ProductLinkService to help 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 property: 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 area sort.
• Asset area varieties; Added AssetFieldType.BUSINESS_LOGO., Added help 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 help returning particulars about qualifying questions of lead type property. When advertisers counsel a qualifying query, it’s going to be reviewed and authorized earlier than getting used within the lead kinds.

Batch Jobs

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

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 property belonging to the Sensible marketing campaign. This must be most well-liked over different standing fields—for instance, Marketing campaign.primary_status or Marketing campaign.primary_status_reasons for Sensible campaigns.
• Changed AdGroup.explorer_auto_optimizer_setting with AdGroup.optimized_targeting_enabled to help optimized concentrating on. That is for the next AdvertisingChannelType: DISPLAY, VIDEO, DISCOVERY. This area is for allowlisted prospects 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 probably be returned in the event you add a ClickConversion with user_identifiers set utilizing ConversionUploadService.UploadClickConversion, however haven’t accepted the shopper knowledge phrases.
• ConversionUploadError.CLICK_CONVERSION_ALREADY_EXISTS will probably be returned in the event 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 probably be returned if you have not adopted the setup directions earlier than utilizing enhanced conversions for leads.
• Added ConversionActionType.WEBPAGE_CODELESS to symbolize conversions created from web site occasions.

Standards

• Added CampaignCriterion.local_service_id and LocalServiceIdInfo to permit for including and eradicating companies an advertiser serves to a Native Providers Marketing campaign.
• CampaignCriterionError.AT_LEAST_ONE_LOCAL_SERVICE_ID_CRITERION_REQUIRED_FOR_LOCAL_SERVICES_CAMPAIGN will probably be returned in the event you try and take away the final marketing campaign criterion that incorporates local_service_id from a Native Providers Marketing campaign.
• CampaignCriterionError.LOCAL_SERVICE_ID_NOT_FOUND_FOR_CATEGORY will probably be returned in the event 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 may 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.

Lodge & Journey

• Added help 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 prospects solely: Added TravelAssetSuggestionService to counsel required photos and textual content property (equivalent to headlines, descriptions, lengthy descriptions) for use to create asset teams in Efficiency Max for journey purpose campaigns.
• Allowlisted prospects solely: Added help 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, Stories, 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 indicate the campaigns focused by the advice.
  Eliminated ResponsiveSearchAdAssetRecommendation.current_ad.

Purchasing

• Eliminated ProductBiddingCategoryInfo.country_code.
• Added help 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 help offering extra particulars in regards to the purpose of the Goal CPM bidding technique.
• Added AdvertisingChannelSubType.VIDEO_REACH_TARGET_FREQUENCY.
• Added PlacementType.GOOGLE_PRODUCTS.

Discussion board dialogue at Twitter.