Google Adverts API Model 13.0 Now Out

Google has launched Google Adverts API model 13.0 and beneath is an inventory of what modified. The massive adjustments embrace Efficiency max for journey objectives and remarketing with rule-based person 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 utterly cease working on the finish of July.

Google printed a video of the main adjustments in 13.0:

Right here is the total record of adjustments:

Account Administration

• Added ProductLinkService to assist including and eradicating a hyperlink between a Google Adverts account and one other product. That is just 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 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 a substitute.
• Added QualifyingQuestion and qualifying_question to assist returning particulars about qualifying questions of lead kind property. When advertisers recommend a qualifying query, it’s going to 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 area.

Billing

• Added InvalidActivitySummary to permit for returning extra particulars concerning 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 needs to 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 assist optimized focusing on. That is for the next AdvertisingChannelType: DISPLAY, VIDEO, DISCOVERY. This area 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 when 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 likely be returned when you attempt to add the identical mixture of gbraid, conversion_action, and conversion_date_time on totally 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 companies 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 when you try and take away the final marketing campaign criterion that accommodates local_service_id from a Native Companies Marketing campaign.
• CampaignCriterionError.LOCAL_SERVICE_ID_NOT_FOUND_FOR_CATEGORY will likely be returned when you try so as to add a marketing campaign criterion that accommodates 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.

Lodge & Journey

• Added assist for Efficiency Max for journey objectives with the next new fields, sources, 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 pictures and textual content property (corresponding to headlines, descriptions, lengthy descriptions) for use to create asset teams in Efficiency Max for journey aim campaigns.
• Allowlisted clients solely: Added assist for Issues to do adverts campaigns by including the next new fields, sources, and enums: Fields, Enums, For marketing campaign creation, For advert group creation,
  Errors, Experiences, 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.

Purchasing

• 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 adverts: VideoBumperInStreamAdInfo.action_button_label, VideoBumperInStreamAdInfo.action_headline
• Added TargetCpm.target_frequency_goal and TargetCpmTargetFrequencyGoal to assist offering extra particulars concerning the aim of the Goal CPM bidding technique.
• Added AdvertisingChannelSubType.VIDEO_REACH_TARGET_FREQUENCY.
• Added PlacementType.GOOGLE_PRODUCTS.

Discussion board dialogue at Twitter.