最后一次调用 Google广告Ads API v12

使用 v12 的开发人员需要迁移到较新的版本，以确保 API 访问不受影响。

建议开发人员在此之前迁移到更新版本，以确保 API 访问不受影响。

为什么我们关心。 API 更新对广告活动的运作方式有直接影响。当不再支持旧版本时，使用它的请求将失败，这可能会扰乱活动管理。为了防止这种情况，继续使用最新的 API 版本非常重要。这样，广告商和开发人员就可以访问新功能，确保广告活动顺利运行并表现良好。

折旧和日落时间表。通常，三个主要版本同时可用，生命周期约为 12 个月，而次要版本的支持生命周期为 10 个月。开发人员每年最多必须执行两次升级，但您不必按照严格的顺序进行升级。

最后一次调用 Google广告Ads API v12

下表列出了每个可用版本的具体弃用和日落日期，以及未来版本的预计发布日期。

尽快迁移。要迁移到最新版本，请访问此处的Google Ads API 文档。

部分介绍如下：

发行说明

书签边框
v14 .1 . 0 (2023-08-09)
v14.1 中添加了以下功能和更改。

帐户管理
Customer.customer_agreement_setting 显示客户是否已接受潜在客户表格服务条款
资产
新字段AssetGroup显示资产组是否正在提供服务或未提供服务的原因：
primary_status
primary_status_reasons
AssetGroupAsset用于显示资产组资产是否正在提供服务或未提供服务的原因的新字段：
primary_status
primary_status_details
primary_status_reasons
枚举中的新值 CallToActionType ：
BUY_NOW
DONATE_NOW
ORDER_NOW
PLAY_NOW
SEE_MORE
START_NOW
VISIT_SITE
WATCH_NOW
枚举中的新值 AssetLinkError：
CUSTOMER_NOT_VERIFIED
UNSUPPORTED_CALL_TO_ACTION
PAGE_FEED_INVALID_LABEL_TEXT
计费
Invoice和中的新字段AccountSummary：
export_charge_subtotal_amount_micros
export_charge_tax_amount_micros
export_charge_total_amount_micros
活动
枚举中的新值 CampaignPrimaryStatusReason ：

HAS_ASSET_GROUPS_DISAPPROVED
HAS_ASSET_GROUPS_LIMITED_BY_POLICY
MOST_ASSET_GROUPS_UNDER_REVIEW
DiscoveryCampaignSettings （仅限允许的帐户） upgraded_targeting：

当upgraded_targeting设置为时true，您可以添加位置和语言作为广告组条件
标准
新的枚举值： CriterionError.INVALID_DETAILED_DEMOGRAPHIC

（仅限允许的帐户）支持添加LanguageInfo和 LocationInfo作为 AdGroupCriterion：

这仅适用于启用了升级定位的发现广告系列
实验
枚举中的新值 ExperimentError：
DUPLICATE_EXPERIMENT_CAMPAIGN_NAME
CANNOT_REMOVE_IN_CREATION_EXPERIMENT
CANNOT_ADD_CAMPAIGN_WITH_DEPRECATED_AD_TYPES
建议
新类型的推荐：
PerformanceMaxOptInRecommendation 建议在帐户中创建第一个效果最大化广告系列
ImprovePerformanceMaxAdStrengthRecommendation 建议提高资产组的效果最大化广告系列的强度
MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation 建议将动态搜索广告系列迁移到效果最大化广告系列
报告
关于新客户与回头客的新指标和细分：
metrics.new_customer_lifetime_value
metrics.all_new_customer_lifetime_value
segments.new_versus_returning_customers
新内容customer_search_term_insight 和campaign_search_term_insight 观点：

metrics.search_volume显示搜索词洞察类别的数量范围

购物
用于列出组的新字段：
ListingGroupInfo.path
AssetGroupListingGroupFilter.path
新领域：ShoppingSetting.advertising_partner_ids
枚举中的新值CampaignError：
NOT_LINKED_ADVERTISING_PARTNER
INVALID_NUMBER_OF_ADVERTISING_PARTNER_IDS
视频
（仅限允许列出的帐户） AdType.DISCOVERY_VIDEO_RESPONSIVE_AD 及其相应的 DiscoveryVideoResponsiveAdInfo
v14 (2023-06-07)

v14 中添加了以下功能和更改。

活动
添加CampaignBudgetError.BUDGET_AMOUNT_MUST_BE_UNSET_FOR_CUSTOM_BUDGET_PERIOD
转换
添加了对识别 Google Analytics（分析）转化并确定转化是从 Universal Analytics 还是 GA4 媒体资源导入的支持：

添加了以下值ConversionActionType：
UNIVERSAL_ANALYTICS_GOAL
UNIVERSAL_ANALYTICS_TRANSACTION
GOOGLE_ANALYTICS_4_CUSTOM
GOOGLE_ANALYTICS_4_PURCHASE
添加ConversionAction.google_analytics_4_settings
添加Customer.offline_conversion_client_summaries，汇总客户离线转化上传和调整的状态和诊断信息。

枚举
OfflineEventUploadClient：
GOOGLE_ADS_API
GOOGLE_ADS_WEB_CLIENT
ADS_DATA_CONNECTOR
OfflineConversionDiagnosticStatus：
EXCELLENT
GOOD
NEEDS_ATTENTION
NO_RECENT_UPLOAD
添加job_id到由返回的响应中并将响应ConversionAdjustmentUploadService.UploadConversionAdjustments与 .ConversionUploadService.UploadClickConversionsOfflineConversionUploadSummary.job_id

标准
添加了对检索、创建和更新帐户级否定关键字的支持：

领域：
CustomerNegativeCriterion.negative_keyword_list
枚举：
CriterionType.NEGATIVE_KEYWORD_LIST
SharedSetType.ACCOUNT_LEVEL_NEGATIVE_KEYWORDS
ResourceLimitType
SHARED_SETS_PER_ACCOUNT_FOR_ACCOUNT_LEVEL_NEGATIVE_KEYWORDS
ACCOUNT_LEVEL_NEGATIVE_KEYWORDS_PER_SHARED_SET
错误：
CriterionError
NEGATIVE_KEYWORD_SHARED_SET_DOES_NOT_EXIST
CANNOT_ADD_REMOVED_NEGATIVE_KEYWORD_SHARED_SET
CANNOT_HAVE_MULTIPLE_NEGATIVE_KEYWORD_LIST_PER_ACCOUNT
CUSTOMER_CANNOT_ADD_CRITERION_OF_THIS_TYPE
添加CriterionError.CANNOT_TARGET_SIMILAR_USER_LIST

酒店广告
重命名SuggestTravelAssetsRequest.place_id为 SuggestTravelAssetsRequest.place_ids
规划
从中删除了以下方法KeywordPlanService：
GenerateForecastCurve
GenerateForecastMetrics
GenerateForecastTimeSeries
GenerateHistoricalMetrics
添加KeywordPlanIdeaService.GenerateKeywordForecastMetrics了支持生成关键字广告系列预测指标，而无需先创建关键字计划。
删除了对检索campaign_criterion_simulation报告的支持
YOUTUBE_DYNAMIC_LINEUP添加了对作为维度的支持AudienceInsightsService.ListAudienceInsightsAttributes。
添加DynamicLineupAttributeMetadata.sample_channels，在响应中使用 GenerateAudienceCompositionInsights以提供阵容中的示例频道。
建议
添加了DynamicImageExtensionOptInRecommendation建议在帐户上启用动态图像扩展的建议
添加了LowerTargetRoasRecommendation建议降低目标广告支出回报率的内容
添加了RaiseTargetCpaRecommendation建议提高目标每次转化费用的内容
添加ResponsiveSearchAdAssetRecommendation.current_ad
报告
向中添加了以下值ServedAssetFieldType，这些值可从中获取ad_group_ad_asset_view.pinned_field：
SITELINK
CALL
MOBILE_APP
CALLOUT
STRUCTURED_SNIPPET
PRICE
PROMOTION
AD_IMAGE
LEAD_FORM
BUSINESS_LOGO
v13.1.0 (2023-04-26)
v13.1 中添加了以下功能和更改。

资产
LeadFormField.has_location_answer 支持显示与活动或具有潜在客户表单的客户关联的位置资产中的位置。

伴随错误：

AssetError.LEAD_FORM_LOCATION_ANSWER_TYPE_DISALLOWED
AssetLinkError.CANNOT_LINK_LOCATION_LEAD_FORM_WITHOUT_LOCATION_ASSET
枚举中的新值AssetGroupError：

PATH1_REQUIRED_WHEN_PATH2_IS_SET
SHORT_DESCRIPTION_REQUIRED
FINAL_URL_REQUIRED
FINAL_URL_CONTAINS_INVALID_DOMAIN_NAME
AD_CUSTOMIZER_NOT_SUPPORTED
CANNOT_MUTATE_ASSET_GROUP_FOR_REMOVED_CAMPAIGN
观众
枚举中的新值 UserListError：
APP_ID_NOT_ALLOWED
CANNOT_MUTATE_SYSTEM_LIST
MOBILE_APP_IS_SENSITIVE
活动
支持使用来返回效果最大化campaign_simulation广告系列级出价模拟。
（仅限已列入许可名单的帐户） Campaign.listing_type以及效果最大化ListingType广告系列。该字段正在取代，后者仅用于智能购物广告系列。ShoppingSetting.use_vehicles_inventory
转换
CustomerSkAdNetworkConversionValueSchemaService.MutateCustomerSkAdNetworkConversionValueSchema 使广告商能够为 iOS 应用广告活动定义 SKAdNetwork 转化价值架构。
新的枚举值： CustomConversionGoalError.NON_BIDDABLE_CONVERSION_ACTION_NOT_ELIGIBLE_FOR_CUSTOM_GOAL
规划
以下请求和响应对象中的新字段 AudienceInsightsService：
GenerateAudienceCompositionInsightsRequest.baseline_audience 支持指定与感兴趣的受众进行比较的基线受众。
ListInsightsEligibleDatesResponse.last_thirty_daysGenerateAudienceCompositionInsights 支持检索请求中使用的当前默认日期范围。
建议
recommendation 购物广告系列和Google Merchant Center的新类型：
shopping_add_age_group_recommendation
shopping_add_color_recommendation
shopping_add_gender_recommendation
shopping_add_gtin_recommendation
shopping_add_more_identifiers_recommendation
shopping_add_size_recommendation
shopping_add_products_to_campaign_recommendation
shopping_fix_disapproved_products_recommendation
shopping_target_all_offers_recommendation
shopping_fix_suspended_merchant_center_account_recommendation
shopping_fix_merchant_center_account_suspension_warning_recommendation
shopping_migrate_regular_shopping_campaign_offers_to_performance_max_recommendation
报告
新指标：
metrics.average_target_cpa_micros 显示平均目标每次转化费用。
metrics.average_target_roas 显示平均目标 ROAS。