SEARCHENGINES

Google Ads API Version 12.0 Now Out

Published

2 years ago

October 28, 2022

Google has released version 12.0 of the Google Ads API. Version 11.0 of the Google Ads API was released in June, and version 11.1 was in August. Version 12.0 is a major update.

Also Version 10.1 was released on April 27, 2022 and version 10.0 was released on February 9, 2022. And Google has sunset the AdWords API on April 27th which will completely stop working at the end of July.

Google published a video of the mahor changes in 12.0:

Here is everything announced in version 12.0:

Account Management

Added a new account link type, ADVERTISING_PARTNER for linking a customer account to another one. This is preparation for an upcoming feature in a following release.

Added AccountLinkError.PERMISSION_DENIED for the case where a non-admin user tries to create an account link.

Ads

Removed support for creating a new Gmail ad. Use Discovery campaigns instead.

Assets

Added support for retrieving CustomLeadFormSubmissionField through LeadFormSubmissionData using GoogleAdsService.SearchStream or GoogleAdsService.Search.

Added support for adding, updating, and removing CampaignAsset and AdGroupAsset with the field_type as AD_IMAGE (for allowlisted customers only).

You can retrieve stats for Image assets (asset_field_type_view.field_type = AD_IMAGE) using the asset_field_type_view report.

The asset_set_asset report now supports metrics and segments.

Added ad_group_ad_asset_view.pinned_field to allow filtering by a pinned asset.

Added support for segment.conversion_action to the ad_group_ad_asset_view report.

Added support for linking customers and ad groups with asset sets for test accounts only.

CustomerAssetSetService for adding/updating/removing CustomerAssetSet, which represents a link between a Customer and an AssetSet.

AdGroupAssetSetService for adding/updating/removing AdGroupAssetSet, which represents a link between an AdGroup and an AssetSet.

Added support for mutating and fetching location assets for test accounts only.

Fields:

Added Asset.location_asset whose type is LocationAsset.

Added the following fields to AssetSet:

location_group_parent_asset_set_id

asset_set_source (oneof field)

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 Campaign and AdGroup.

Enums:

Added AssetType.LOCATION.

Added the following values to AssetSetType:

LOCATION_SYNC

BUSINESS_PROFILE_DYNAMIC_LOCATION_GROUP

CHAIN_DYNAMIC_LOCATION_GROUP

STATIC_LOCATION_GROUP

Reports (available for all accounts):

per_store_view returns stats at the place ID level.

asset_set_type_view returns stats at the AssetSetType level, which currently only supports location asset set.

Audiences

Added the following values to OfflineUserDataJobFailureReason: HIGH_AVERAGE_TRANSACTION_VALUE, LOW_AVERAGE_TRANSACTION_VALUE, NEWLY_OBSERVED_CURRENCY_CODE

Bidding

Added support for linked portfolio bidding strategies and campaign budget. Bidding strategies and campaign budgets can modify these links using bulk mutates:

BiddingStrategy.aligned_campaign_budget_id

CampaignBudget.aligned_bidding_strategy_id

Billing

Added AccountSummary as Invoice.account_summaries[] for reporting reconciliation (for allowlisted customers only).

Added BillingSetupError.TOO_MANY_BILLING_SETUPS_FOR_PAYMENTS_ACCOUNT.

Added AccountBudgetProposalError.INVALID_MASTER_SERVICE_AGREEMENT.

Campaigns

Changes in Smart campaigns:

Updated SmartCampaignSuggestService.SuggestKeywordThemes to generate more keyword theme suggestions for Smart campaigns and can suggest free-form keyword themes in some cases.

Improved error handling and added more user-facing error codes for SmartCampaignSuggestService.SuggestKeywordThemes.

Removed support for creating new Smart Display campaigns. Existing Smart Display campaigns still serve as usual.

OperationAccessDeniedError.CREATE_OPERATION_NOT_PERMITTED is thrown if you try to create a new Smart Display campaign.

Added the following fields to Campaign:

primary_status to provide insight into why a campaign is not serving or not serving optimally.

primary_status_reasons to provide reasons into why a campaign is not serving or not serving optimally. These reasons are aggregated to determine primary_status.

Enabled adding and removing location targeting to Local Services campaigns except for proximity targeting.

Added the following errors to CampaignCriterionError for the Local 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 always be > 0 for all customers. Previously, this field could be 0 for customers who hadn’t created any conversion actions before.

Added debug_enabled for performing all checks and returning errors if found when uploading enhanced conversions.

Criteria

Added the following asset set fields to LocationGroupInfo for test accounts:

enable_customer_level_location_asset_set

location_group_asset_sets

Added the following 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 changed for the following fields.
BiddingStrategy.currency_code
BiddingStrategy.scheme
BiddingStrategy.type
TargetCpa.target_cpa_micros
TargetImpressionShare.cpc_bid_ceiling_micros
TargetSpend.target_spend_micros (deprecated)

Experiments

Removed CampaignExperimentService in favor of the previously added new experiments.
Renamed ExperimentArm.trial to ExperimentArm.experiment.

When you create a new experiment arm using MutateExperimentArms and set response_content_type of your mutate request toMUTABLE_RESOURCE, it now also populates values in ExperimentArm.in_design_campaigns.

Feeds

Added LEGACY_FEED_TYPE_READ_ONLY to the following enums: CampaignFeedError, FeedItemError, FeedMappingError

Planning

AudienceInsightsService.ListAudienceInsightsAttributes now accepts AudienceInsightsDimension.GEO_TARGET_COUNTRY and AudienceInsightsDimension.SUB_COUNTRY_LOCATION, enabling clients to discover the location criteria that can be used in AudienceInsightsService.

Added AudienceInsightsService.ListInsightsEligibleDates (available to allowlisted accounts only), enabling clients to discover the set of date ranges that can be used in AudienceInsightsService.

Removed GenerateProductMixIdeas from ReachPlanService.

Added Targeting.plannable_location_ids, which supports targeting multiple geo locations within the same parent location in a single reach forecast.

Recommendations

Added RaiseTargetCpaBidTooLowRecommendation which identifies target CPA adjustments to help campaigns start serving.

Added ForecastingSetTargetRoasRecommendation which identifies target ROAS adjustments to capture additional conversion value from expected traffic increases.

Reporting