Google Advertisements API Model 12.0 Now Out

Google has launched model 12.0 of the Google Advertisements API. Model 11.0 of the Google Advertisements API was launched in June, and model 11.1 was in August. Model 12.0 is a significant replace.

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 printed a video of the mahor modifications in 12.0:

Right here is all the pieces introduced in model 12.0:

Account Administration

• Added a brand new account hyperlink kind, ADVERTISING_PARTNER for linking a buyer account to a different one. That is preparation for an upcoming characteristic in a following launch.
• Added AccountLinkError.PERMISSION_DENIED for the case the place a non-admin consumer tries to create an account hyperlink.

Advertisements

• Eliminated assist for creating a brand new Gmail advert. Use Discovery campaigns as an alternative.

Property

• Added assist for retrieving CustomLeadFormSubmissionField by means of LeadFormSubmissionData utilizing GoogleAdsService.SearchStream or GoogleAdsService.Search.
• Added assist for including, updating, and eradicating CampaignAsset and AdGroupAsset with the field_type as AD_IMAGE (for allowlisted prospects solely).
• You may retrieve stats for Picture belongings (asset_field_type_view.field_type = AD_IMAGE) utilizing the asset_field_type_view report.
• The asset_set_asset report now helps metrics and segments.
• Added ad_group_ad_asset_view.pinned_field to permit filtering by a pinned asset.
• Added assist for phase.conversion_action to the ad_group_ad_asset_view report.
• Added assist for linking prospects and advert teams with asset units for take a look at accounts solely.
• CustomerAssetSetService for including/updating/eradicating CustomerAssetSet, which represents a hyperlink between a Buyer and an AssetSet.
• AdGroupAssetSetService for including/updating/eradicating AdGroupAssetSet, which represents a hyperlink between an AdGroup and an AssetSet.


Added assist for mutating and fetching location belongings for take a look at accounts solely.

• Fields:
• Added Asset.location_asset whose kind is LocationAsset.
• Added the next fields to AssetSet:
• location_group_parent_asset_set_id
• asset_set_source (oneof subject)
• location_set (use with CustomerAssetSet)
• business_profile_location_group (use with CampaignAssetSet and AdGroupAssetSet)
• chain_location_group (use with CampaignAssetSet and AdGroupAssetSet)
• Added excluded_parent_asset_set_types to Marketing campaign and AdGroup.
• Enums:
• Added AssetType.LOCATION.
• Added the next values to AssetSetType:
• LOCATION_SYNC
• BUSINESS_PROFILE_DYNAMIC_LOCATION_GROUP
• CHAIN_DYNAMIC_LOCATION_GROUP
• STATIC_LOCATION_GROUP
• Stories (out there for all accounts):
• per_store_view returns stats on the place ID degree.
• asset_set_type_view returns stats on the AssetSetType degree, which at the moment solely helps location asset set.

Audiences

• Added the next values to OfflineUserDataJobFailureReason: HIGH_AVERAGE_TRANSACTION_VALUE, LOW_AVERAGE_TRANSACTION_VALUE, NEWLY_OBSERVED_CURRENCY_CODE

Bidding

• Added assist for linked portfolio bidding methods and marketing campaign funds. Bidding methods and marketing campaign budgets can modify these hyperlinks utilizing bulk mutates:
• BiddingStrategy.aligned_campaign_budget_id
• CampaignBudget.aligned_bidding_strategy_id

Billing

• Added AccountSummary as Bill.account_summaries[] for reporting reconciliation (for allowlisted prospects solely).
• Added BillingSetupError.TOO_MANY_BILLING_SETUPS_FOR_PAYMENTS_ACCOUNT.
• Added AccountBudgetProposalError.INVALID_MASTER_SERVICE_AGREEMENT.

Campaigns

• Adjustments in Good campaigns:
• Up to date SmartCampaignSuggestService.SuggestKeywordThemes to generate extra key phrase theme solutions for Good campaigns and may counsel free-form key phrase themes in some circumstances.
• Improved error dealing with and added extra user-facing error codes for SmartCampaignSuggestService.SuggestKeywordThemes.
• Eliminated assist for creating new Good Show campaigns. Current Good Show campaigns nonetheless function standard.
• OperationAccessDeniedError.CREATE_OPERATION_NOT_PERMITTED is thrown when you attempt to create a brand new Good Show marketing campaign.
• Added the next fields to Marketing campaign:
• primary_status to supply perception into why a marketing campaign is just not serving or not serving optimally.
• primary_status_reasons to supply causes into why a marketing campaign is just not serving or not serving optimally. These causes are aggregated to find out primary_status.
• Enabled including and eradicating location focusing on to Native Providers campaigns aside from proximity focusing on.
• Added the next errors to CampaignCriterionError for the Native service campaigns:
• AT_LEAST_ONE_POSITIVE_LOCATION_REQUIRED_FOR_LOCAL_SERVICES_CAMPAIGN
• CANNOT_ADD_OR_REMOVE_LOCATION_FOR_LOCAL_SERVICES_CAMPAIGN
• CANNOT_TARGET_COUNTRY_FOR_LOCAL_SERVICES_CAMPAIGN
• LOCATION_INVALID_FOR_LOCAL_SERVICES_CAMPAIGN
• LOCATION_NOT_IN_HOME_COUNTRY_FOR_LOCAL_SERVICES_CAMPAIGN
• LOCATION_NOT_LAUNCHED_FOR_LOCAL_SERVICES_CAMPAIGN

Conversions

• conversion_tracking_id will at all times be > 0 for all prospects. Beforehand, this subject could possibly be 0 for purchasers who hadn’t created any conversion actions earlier than.
• Added debug_enabled for performing all checks and returning errors if discovered when importing enhanced conversions.

Standards

• Added the next asset set fields to LocationGroupInfo for take a look at accounts:
• enable_customer_level_location_asset_set
• location_group_asset_sets
• Added the next values to CriterionError:
• CANNOT_SET_ASSET_SET_FIELD_FOR_CUSTOMER
• CANNOT_SET_ASSET_SETS_WITH_FEED_ITEM_SETS
• CANNOT_SET_BOTH_ASSET_SET_AND_FEED
• CANNOT_SET_FEED_OR_FEED_ITEM_SETS_FOR_CUSTOMER
• CANNOT_SET_GEO_TARGET_CONSTANTS_WITH_ASSET_SETS
• INVALID_LOCATION_GROUP_ASSET_SETS

Errors

• Error codes returned for some invalid operations have modified for the next fields.
• BiddingStrategy.currency_code
• BiddingStrategy.scheme
• BiddingStrategy.kind
• TargetCpa.target_cpa_micros
• TargetImpressionShare.cpc_bid_ceiling_micros
• TargetSpend.target_spend_micros (deprecated)

Experiments

• Eliminated CampaignExperimentService in favor of the beforehand added new experiments.
  Renamed ExperimentArm.trial to ExperimentArm.experiment.
• While you create a brand new experiment arm utilizing MutateExperimentArms and set response_content_type of your mutate request toMUTABLE_RESOURCE, it now additionally populates values in ExperimentArm.in_design_campaigns.

Feeds

• Added LEGACY_FEED_TYPE_READ_ONLY to the next enums: CampaignFeedError, FeedItemError, FeedMappingError

Planning

• AudienceInsightsService.ListAudienceInsightsAttributes now accepts AudienceInsightsDimension.GEO_TARGET_COUNTRY and AudienceInsightsDimension.SUB_COUNTRY_LOCATION, enabling shoppers to find the situation standards that can be utilized in AudienceInsightsService.
• Added AudienceInsightsService.ListInsightsEligibleDates (out there to allowlisted accounts solely), enabling shoppers to find the set of date ranges that can be utilized in AudienceInsightsService.
• Eliminated GenerateProductMixIdeas from ReachPlanService.
• Added Focusing on.plannable_location_ids, which helps focusing on a number of geo places throughout the identical mother or father location in a single attain forecast.

Suggestions

• Added RaiseTargetCpaBidTooLowRecommendation which identifies goal CPA changes to assist campaigns begin serving.
• Added ForecastingSetTargetRoasRecommendation which identifies goal ROAS changes to seize extra conversion worth from anticipated site visitors will increase.

Reporting

• Added assist for returning the variety of clicks for sitelinks (when segments.click_type = SITELINKS) within the landing_page_view report.
• Added the next bought site visitors metrics: metrics.publisher_purchased_clicks,
  metrics.publisher_organic_clicks, metrics.publisher_unknown_clicks

Discussion board dialogue at Twitter.