如需查看当前和计划弃用的功能的最新列表，请参阅功能弃用。
v24 主要版本和次要版本
Google Ads API v24 包含以下新功能、更新和重大变更。
v24.2（2026 年 6 月 24 日）
Google Ads API v24.2 中添加了以下新功能和更新。次要版本（例如 v24.2）不包含重大更改。
v24.1 (2026-05-13)
Google Ads API v24.1 中添加了以下新功能和更新。v24.1 等次要版本不包含重大更改。
| 功能和更新 | 类型 | 说明 |
|---|---|---|
| Ads | ||
DemandGenMultiAssetAdInfo.classic_display_images |
新字段 | 投放自定义上传的展示图片，无需额外的自适应素材资源。 |
| 实验 | ||
ADOPT_AI_MAX ADOPT_BROAD_MATCH_KEYWORDS OPTIMIZE_ASSETS PMAX_REPLACEMENT_SHOPPING |
新枚举值 | 添加了对新的 ExperimentType 类型的支持：
|
Experiment.video_experiment |
新字段 | 为包含视频广告系列的现有 YOUTUBE_CUSTOM 实验提供配置支持。 |
ExperimentArm.asset_testing_info ExperimentArm.asset_groups ExperimentArm.performance_max_experiment_arm_info |
新字段 | 公开了以下字段，以支持实验组中的素材资源测试、素材资源组和效果最大化广告系列设置：
|
| 常规 | ||
CustomerUserAccess.passkey_enabled |
新字段 | 只读字段，用于指明用户是否已启用通行密钥。 |
| 报告 | ||
mobile_device_platform |
新建细分受众群 | 允许按用户设备的平台（例如 iOS 或 Android）细分报告。 |
REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED |
新枚举值 / 错误 | 当查询日期范围不支持所请求的每日、每小时或每周时间粒度时返回（仅适用于过去 37 个月）。 |
vertical_ads_listing_user_rating vertical_ads_listing_venue |
新细分 | 用于竖屏广告的新细分受众群。 |
user_rating、venue、event_participant_display_name |
新过滤条件 | 在 VerticalAdsItemGroupRuleInfo 中针对 SharedCriterion 资源支持过滤。 |
| 控制组/实验组实验指标 | 新字段 | 在七个核心指标系列（点击次数、展示次数、费用、转化次数、每次转化费用、转化价值、每次费用带来的转化价值）中添加了控制值（control_clicks 等）、处理值（clicks 等）、点估计值（clicks_point_estimate 等）、边际误差（clicks_margin_of_error 等）和 p 值（clicks_p_value 等）。 |
| 转化次数绝对变化指标 | 新字段 | 支持使用点估计值、边际误差和 p 值字段进行Conversions 绝对差估计。 |
| 定位 | ||
CriterionErrorEnum.CANNOT_EXCLUDE_ALL_TARGETS |
新枚举值 / 错误 | 尝试排除所有受众特征定位条件时返回。 |
| 视频 | ||
ThirdPartyViewabilityIntegrationPartnerEnum.ZEFR |
新枚举值 | 将 ZEFR 发布为第三方可见度集成合作伙伴。 |
DataLink.youtube_video.channel_id |
新字段 | 公开与数据关联相关联的 YouTube 频道 ID。 |
v24 (2026-04-22)
Google Ads API v24（一个主要版本）中新增了以下功能、更新和重大变更。
如需相关指导，请参阅升级到最新版本。
破坏性更改
功能和更新（非破坏性）
| 功能和更新 | 类型 | 说明 |
|---|---|---|
| Ads | ||
VideoResponsiveAdInfo 的可变性 |
行为变化 | 自适应视频广告信息对象现在可变。 |
| 素材资源 | ||
AssetSet 中的 travel_feed_data |
新字段 | 添加了用于检索旅游 Feed 素材资源属性（hotel_center_account_id、merchant_center_id、partner_center_id、subset_id、travel_feed_vertical_type）的方法。 |
| 广告系列 | ||
Campaign.view_through_conversion_optimization_enabled |
新字段 | 允许在需求开发广告系列和应用广告系列中启用浏览型转化 (VTC) 优化功能（默认值为 false）。 |
CampaignCriterion.gender |
新功能 | 在所有 Google Ads API 版本中为效果最大化广告系列启用了性别排除对象。 |
| 转化次数 | ||
| 潜在客户发掘转化类型 | 新枚举值 | 在 ConversionActionType 中添加了新的 GA4/Firebase 转化操作类型枚举：
|
| 常规 | ||
UserListErrorEnum.DUPLICATE_LOOKALIKE |
新枚举值 / 错误 | 尝试创建多个相同的相似受众群体列表时返回。 |
| 规划 | ||
ListPlannableProductsResponse 中的 ProductCoreAttributes 字段 |
新字段 | 在 ListPlannableProductsResponse 下的 ProductCoreAttributes 中添加了可规划的产品说明、营销目标、费用模式和购买方式。 |
| 报告 | ||
CartDataSalesView |
新的报告资源 | 除了点击的商品之外，还提供按所售具体商品（品牌等）细分转化指标的报告。 |
| 不可用于出价的指标 | 新字段 | 向所有匹配的资源添加了不可用于出价的指标（显示广告系列未针对其进行优化的转化的指标）：
|
conversion_attribution_event_type |
新建细分受众群 | 已添加到ShoppingPerformanceView。 |
| 购物 | ||
ShoppingProduct 中的应用广告系列 |
新功能 | ShoppingProduct 资源中支持的应用广告系列。不支持注释状态和问题。 |
| 基于代码的商品过滤 | 新功能 | 引入了使用逻辑集表达式动态过滤的功能：
|
v23 主要版本和次要版本
Google Ads API v23 包含以下新功能、更新和重大变更。
v23.3 (2026-06-24)
Google Ads API v23.3 中添加了以下新功能和更新。v23.3 等次要版本不包含重大更改。
| 功能和更新 | 类型 | 说明 |
|---|---|---|
| 常规 | ||
Asset.synthetic_content_info Ad.synthetic_content_info |
新字段 | 包含针对合成内容/AI 生成的内容的证明，分为 advertiser_attestation（广告客户直接提供的声明）和 system_attestation（Google 系统自动检测到或提供的证明）。
为了帮助您规划即将针对 v25 进行的集成工作，我们提前针对 v22 及更高版本推出了用于更改广告客户证明字段的接口。该接口在这些版本中可见，但 如果您尝试对这两个字段中的任一字段发出 mutate 请求，系统将返回以下错误之一： “尝试变异的字段不可变”或“无法设置字段”。 从 v25 开始，这些字段将完全可变。我们建议您立即使用该接口来构建和测试内部逻辑，以便您的系统在 v25 发布时能够支持完整的写入功能。 |
| 多方审批 | 新功能 |
添加了对多方审批 (MPA) 审核的支持：
|
v23.2 (2026-03-25)
Google Ads API v23.2 中添加了以下新功能和更新。v23.2 等次要版本不包含重大更改。
| 功能和更新 | 类型 | 说明 |
|---|---|---|
| 素材资源 | ||
VideoEnhancement |
新建资源 | 包含特定于增强功能的视频广告信息，例如是 Google 生成的还是广告客户提供的。如需了解详情，请参阅视频增强功能简介。 |
AppTopCombinationView |
新建资源 | 只读资源，用于提供有关应用广告系列中效果最佳的素材资源组合的分析洞见。 |
CustomerAsset |
新功能 | 添加了对检索 CustomerAsset 的支持，并将 field_type 设置为 BUSINESS_LOGO。 |
| 广告系列 | ||
AdGroupAd.start_date_time AdGroupAd.end_date_time |
新字段 | 提供更精细的广告系列日期安排限制。仅受部分广告组类型支持。 |
HotelSettingInfo.disable_hotel_setting |
新字段 | 允许在需求开发广告系列中停用酒店 Feed。 |
| 常规 | ||
CustomerClientLinkError |
新的枚举值 / 错误 | 添加了两个新的错误代码：MAX_CUSTOMER_LIMIT_REACHED 和 ACCOUNT_CREATION_POLICY_VIOLATION。 |
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS |
行为变化 | 现在，如果尝试使用此已弃用的用户名单客户类型类别，系统会抛出错误。 |
| 规划 | ||
GenerateTrendingInsights GenerateCreatorInsights |
新功能 | 新增了对实体、主题和受众群体的自定义 AND/OR 组合的支持。 |
ReachPlanService.GenerateReachForecast |
新枚举值 | 添加了新的可定位年龄范围，例如 AGE_RANGE_21_44 或 AGE_RANGE_21_49。 |
youtube_select_lineup_targeting |
新字段 | 已添加到 ReachPlanService.ListPlannableProducts，将取代 youtube_select_lineups。目前，这两个字段都已填充。 |
ReachPlanSurface |
新枚举值 | 添加了 IN_STREAM_NON_SKIPPABLE_THIRTY_SECONDS 作为展示平台选项。 |
Forecast |
新字段 | 在 ReachPlanService.GenerateReachForecast 中为需求开发广告系列的“尽可能争取更多点击次数”（每次点击费用）添加了 clicks。 |
partnership_opportunities |
新字段 | 已添加到 ContentCreatorInsightsService.GenerateCreatorInsights 和 ContentCreatorInsightsService.GenerateTrendingInsights。 |
| 报告 | ||
biddable_indirect_install_first_in_app_conversion_micros |
新字段 | 已添加到 Campaign、Customer 和 AdGroup 资源。 |
| 视频 | ||
ShareablePreviewService |
新功能 | 扩展为通过将 preview_type 设置为 YOUTUBE_LIVE_PREVIEW 来支持 YouTube 直播预览。向 ShareablePreviewError 添加了 UNSUPPORTED_AD_TYPE 和 TOO_MANY_RESOURCES_IN_REQUEST。仅受部分广告类型支持。 |
v23.1（2026 年 2 月 25 日）
Google Ads API v23.1 中添加了以下新功能和更新。v23.1 等次要版本不包含重大更改。
| 功能和更新 | 类型 | 说明 |
|---|---|---|
| 账号管理 | ||
advertising_partner_properties.allowed_domain |
新字段 | 已添加到 ProductLinkInvitation 和 ProductLink 资源。广告合作伙伴只能在此网域上投放广告。 |
Customer.contains_eu_political_advertising |
新字段 | 检索账号级声明状态，即账号是否包含面向欧盟的政治广告，并返回 EuPoliticalAdvertisingStatus。 |
| 广告系列 | ||
Campaign.text_guidelines |
新字段 | 新增了对文案准则的支持，可与效果最大化广告系列和搜索广告系列搭配使用，以程序化方式控制 AI 生成的文案素材资源。在 text_guidelines 中，您可以定义 term_exclusions 和 messaging_restrictions。 |
CampaignPrimaryStatusReason |
新枚举值 | 添加了 CAMPAIGN_NOT_BOOKED、BOOKING_HOLD_EXPIRING、BOOKING_HOLD_EXPIRED 和 BOOKING_CANCELLED，以便为采用 FIXED_CPM 出价策略的广告系列提供主要状态原因。 |
Campaign.VideoCampaignSettings.reservation_ad_category_self_disclosure Campaign.VideoCampaignSettings.booking_details |
新字段 | 添加了对预订型广告类别自行披露和只读预订详情的支持。 |
Campaign.missing_eu_political_advertising_declaration |
新字段 | 支持查询和过滤缺少以下声明的广告系列：是否包含面向欧盟的政治广告。 |
| 转化次数 | ||
ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS |
新枚举值 | 支持跟踪观看广告后又观看同一频道内视频的用户。 |
| 常规 | ||
CriterionErrorEnum.CANNOT_TARGET_ONLY_UNDETERMINED |
新枚举值 / 错误 | 尝试仅定位到人口统计维度中的“未确定”类别时返回。 |
| 奖励 | ||
IncentiveErrorEnum |
新的枚举值 / 错误 | 添加了两个新的错误代码：MAX_INCENTIVES_REDEEMED 和 ACCOUNT_TOO_OLD。对于 2026 年 3 月 11 日当天或之后发出的请求，可能会返回这些错误。 |
| 规划 | ||
GenerateBenchmarksMetrics |
新功能 | 添加了对使用 BreakdownDefinition 进行日期细分的的支持。 |
ReachPlanService.GenerateReachForecast |
新枚举值 | 将 GOOGLE_DISPLAY_NETWORK 添加为需求开发广告系列“尽可能提高转化次数”出价策略的可定位展示位置。 |
GenerateTrendingInsights |
新字段 | 在按主题搜索时，向 TrendInsights 的 TrendInsightDataPoint 中添加了历史趋势线信息。 |
| 报告 | ||
| 唯一身份用户频次指标 | 新字段 | 新增了以下指标，用于报告有多少用户至少看到过您的广告 2 次、3 次、4 次、5 次或 10 次：unique_users_two_plus、unique_users_three_plus、unique_users_four_plus、unique_users_five_plus 和 unique_users_ten_plus。 |
SearchTermMatchSource |
新枚举值 | 添加了 VERTICAL_ADS_DATA_FEED 以支持垂直广告数据 Feed，例如旅游广告实体定位。 |
| YouTubeVideoUpload | ||
YouTubeVideoUpload |
新服务 / 资源 | 添加了 YouTubeVideoUpload 服务，以支持在 YouTube 上上传和管理视频；添加了 YouTubeVideoUpload 资源，以支持获取上传状态和元数据。此功能仅支持 REST 和 Python 客户端库。 |
v23 (2026-01-28)
Google Ads API v23 是一个主要版本，其中添加了以下新功能、更新和重大变更。
如需相关指导，请参阅升级到最新版本。
破坏性更改
| 初始状态 | 新状态 | 更改类型 | 实现方案指导 |
|---|---|---|---|
| Ads | |||
| 允许分享广告 | AdGroupAdError.AD_SHARING_NOT_ALLOWED |
行为转变 | 不再允许在多个广告组之间共享广告。尝试共享广告的请求会返回 AD_SHARING_NOT_ALLOWED 错误。 |
支持 CallAd 和 CallAdInfo |
无 | 移除 | 已移除对来电广告的支持。请参阅关于电话广告这篇帮助中心文章。 |
| 广告系列 | |||
Campaign.start_date Campaign.end_date |
Campaign.start_date_time Campaign.end_date_time |
重命名 / 替换 | 使用新的日期时间字段为广告系列指定时间组成部分。原始的仅包含日期的字段会被移除。 |
| 需求开发 | |||
DemandGenMultiAssetAdInfo.lead_form_only |
无 | 移除 | lead_form_only 字段已移除。更新代码中的引用。 |
| 报告 | |||
| 汇总了素材资源效果标签指标和枚举 | 无 | 移除 | 移除了汇总的资产效果标签指标。不再针对搜索广告系列和展示广告系列返回效果标签枚举。 |
功能和更新（非破坏性）
| 功能和更新 | 类型 | 说明 |
|---|---|---|
| Ads | ||
AdFormatType |
新枚举值 | 添加了新的格式类型：TEXT、VERTICAL_ADS_BOOKING_LINK 和 VERTICAL_ADS_PROMOTION。 |
| 素材资源 | ||
asset_group 查看 |
新字段 | 添加了以下指标：metrics.engagements、metrics.engagement_rate 和 metrics.average_cpe。 |
asset_group_asset 查看 |
新字段 | 添加了以下指标：metrics.average_cpe、metrics.average_cpm、metrics.trueview_average_cpv、metrics.video_trueview_view_rate、metrics.video_trueview_views 和 metrics.interaction_event_types。 |
Asset.orientation |
新字段 | 为图片和视频素材资源添加了只读的屏幕方向字段。 |
CampaignAsset |
新功能 | 新增了对检索 field_type 设置为 HEADLINE 和 DESCRIPTION 的广告系列素材资源的支持。 |
ServedAssetFieldType |
新枚举值 | 为作为站内链接投放的素材资源添加了 HEADLINE_AS_SITELINK_POSITION_ONE、HEADLINE_AS_SITELINK_POSITION_TWO、DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE 和 DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO。 |
BusinessMessageAsset |
新功能 / 支持 | 更新了商家私信素材资源：
|
| 结算 | ||
InvoiceService.ListInvoices |
新选项 | 现在，通过在 ListInvoicesRequest 中设置 include_granular_level_invoice_details，可以在 Invoice 中返回更精细的详细信息，包括广告系列级费用细分、分项列出的监管费用和调整信息。 |
RegulatoryFeeType UnitOfMeasure |
新枚举 | 为监管费用和度量单位添加了辅助枚举。 |
| 广告系列 | ||
CampaignError |
新的枚举值 / 错误 | 添加了 DURATION_TOO_LONG_FOR_TOTAL_BUDGET 和 END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET 错误代码。 |
| 转化次数 | ||
| ConversionActionCategory | 新枚举值 | 添加了 YOUTUBE_FOLLOW_ON_VIEWS 以支持跟踪观看广告后又观看同一频道中视频的用户。 |
| 需求开发 | ||
DemandGenVideoResponsiveAdInfo.companion_banner |
新字段 | 在需求开发自适应视频广告中添加了对随播横幅的支持。 |
| 奖励 | ||
添加了“自选”奖励支持：
为了更精细地以程序化方式处理故障，我们将在未来的版本中向 |
||
| 规划 | ||
AudienceInsightsDimension.LIFE_EVENT_USER_INTEREST |
新枚举值 | 允许在 GenerateAudienceCompositionInsights、GenerateSuggestedTargetingInsights、GenerateInsightsFinderReport 和 GenerateCreatorInsights 中使用“人生大事”来构建受众群体。
其他 |
ReachPlanService.GenerateConversionRates |
新字段 / 选项 | 响应现在包含支持根据平台控件（例如 Gmail、Shorts）提供转化率建议的平台。仅支持需求开发广告系列。 |
LanguageDistribution |
新字段 / 类型 | 已添加到 YouTubeChannelInsights，以提供 YouTube 频道内容中的语言分布详情。 |
BenchmarksService |
新建服务 | 将 YouTube 广告数据与行业基准进行比较。 |
AudienceInsightsService.GenerateAudienceDefinition |
新方法 | 使用生成式 AI 将目标受众群体的自由文本说明转换为匹配的受众群体属性。 |
YouTubeChannelInsights.relevance_score |
新字段 | 评估创作者与某个主题的相关性（按观看次数加权）。 |
TrendInsightMetrics.trend_change_percent |
新字段 | 表示热点价值在比较期内的变化百分比。 |
| 建议 | ||
GenerateRecommendationsRequest |
新字段 | 添加了 is_new_customer。当针对 CAMPAIGN_BUDGET 建议将此属性设置为 true 时，系统会使用针对新客户优化的模型（仅建议没有广告系列的客户使用）。 |
| 报告 | ||
AdGroupAdAssetView |
新功能 / 指标支持 | 现在支持 RESPONSIVE_DISPLAY_AD 的展示、效果和转化指标。 |
ad_sub_network_type 细分 |
新建细分受众群 | 提供广告联盟内的精细效果细分数据。最初适用于 YouTube 上的需求开发广告系列（插播广告、信息流广告、Shorts 广告）。必须与 ad_network_type 一起选择。 |
| 效果最大化广告系列的报告 | 新功能 | 效果最大化广告系列的已启用广告资源网类型细分。 |
UserLocationView GeographicView |
支持新的细分 | 支持按转化日期细分的指标：conversions_by_conversion_date、all_conversions_by_conversion_date、conversions_value_by_conversion_date、all_conversions_value_by_conversion_date、value_per_conversions_by_conversion_date、value_per_all_conversions_by_conversion_date、cross_device_conversions_by_conversion_date 和 cross_device_conversions_value_by_conversion_date。 |
| 竖屏广告细分 | 新细分 | 添加了以下细分：vertical_ads_event_participant_display_names、vertical_ads_hotel_class、vertical_ads_listing、vertical_ads_listing_brand、vertical_ads_listing_city、vertical_ads_listing_country、vertical_ads_listing_region、vertical_ads_partner_account 和 vertical_ads_vertical。 |
PerStoreView MatchedLocationInterestView |
新的报告资源 | 添加了 PerStoreView 来查询实体店位置详细信息，以及 MatchedLocationInterestView（适用于 AI Max 广告系列）来按感兴趣的地理位置提供效果指标。 |
| 购物 | ||
ShoppingPerformanceView |
支持新指标 | 现在支持按转化日期细分的以下指标：conversions_by_conversion_date、all_conversions_by_conversion_date、conversions_value_by_conversion_date、value_per_conversions_by_conversion_date 和 value_per_all_conversions_by_conversion_date。 |
ShoppingPerformanceView |
支持新指标 | 添加了对以下各项的支持：search_budget_lost_impression_share、search_rank_lost_impression_share、search_budget_lost_absolute_top_impression_share 和 search_rank_lost_absolute_top_impression_share。 |
ShoppingProduct.product_image_uri |
新字段 | 已添加到ShoppingProduct。 |
| 竖屏广告 | ||
AdGroup.vertical_ads_format_setting |
新字段 | 可用于控制哪些广告格式可以在使用旅游 Feed 的搜索广告系列中投放。 |
AdGroupCriterion SharedCriterion |
新字段 / 条件 | 向 AdGroupCriterion 和 vertical_ads_item_group_rule 添加了 vertical_ads_item_group_rule_list 条件类型，以允许在包含旅游 Feed 的搜索广告系列中定位商品组。SharedCriterion |
| 竖屏广告数据 Feed 集成 | 新功能 | 现在，您可以将垂直广告数据 Feed 与投放 AI Max 的搜索广告系列相关联，以便在文字广告旁边展示房源宣传广告和预订链接旅游广告。使用 vertical_ads_format_setting 控制格式，并使用 vertical_ads_item_group_rule 定义规则。按 AdFormatType 和垂直广告数据 Feed 维度细分报告。 |
| 视频 | ||
AdVideoAssetInfo.ad_video_asset_feature_control |
新字段 | 为视频广告素材资源添加了功能控制选项。 |
CampaignCriterionError |
新枚举值 / 错误 | 添加了 INVALID_VIDEO_LINEUP_ID 错误代码。 |
| YouTube 可听度指标 | 新指标 | 为 YouTube 上的音频广告添加了可听度指标，用于报告广告是否可听，以及有多少展示次数的可听度可以衡量。 |
v22 主要版本和次要版本
Google Ads API v22 包含以下新功能、更新和重大变更。
v22.2 (2026-06-24)
Google Ads API v22.2 中添加了以下新功能和更新。v22.2 等次要版本不包含重大更改。
| 功能和更新 | 类型 | 说明 |
|---|---|---|
| 常规 | ||
Asset.synthetic_content_info Ad.synthetic_content_info |
新字段 | 包含针对合成/AI 生成的内容的声明，分为 advertiser_attestation（广告客户直接提供的声明）和 system_attestation（Google 系统自动检测到或提供的声明）。
为了帮助您规划即将针对 v25 进行的集成工作，我们提前针对 v22 及更高版本推出了用于更改广告客户证明字段的界面。该接口在这些版本中可见，但 如果您尝试对这两个字段中的任一字段发出 mutate 请求，系统将返回以下错误之一： “尝试变异的字段不可变”或“无法设置字段”。 从 v25 开始，这些字段将完全可变。我们建议您立即使用该接口来构建和测试内部逻辑，以便您的系统在 v25 发布时能够支持完整的写入功能。 |
| 多方审批 | 新功能 |
添加了对多方审批 (MPA) 审核的支持：
|
v22.1（2026 年 2 月 25 日）
Google Ads API v22.1 中新增了以下功能。v22.1 等次要版本不包含破坏性更改。
| 功能和更新 | 类型 | 说明 |
|---|---|---|
| 账号管理 | ||
Customer.contains_eu_political_advertising |
新字段 | 检索账号级声明状态，即账号是否包含面向欧盟的政治广告，并返回 EuPoliticalAdvertisingStatus。 |
| 广告系列 | ||
Campaign.missing_eu_political_advertising_declaration |
新字段 | 支持查询和过滤缺少以下声明的广告系列：是否包含面向欧盟的政治广告。 |
v22（2025 年 10 月 15 日）
Google Ads API v22 是一个主要版本，其中添加了以下新功能、更新和重大变更。
如需相关指导，请参阅升级到最新版本。
破坏性更改
| 初始状态 | 新状态 | 更改类型 | 实现方案指导 |
|---|---|---|---|
| 需求开发 | |||
BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros |
minimum_budget_amount_micros |
重命名 / 拼写修正 | 重命名引用以使用更正后的字段名称。 |
| 常规 | |||
AddBatchJobOperations 中没有操作限制 |
每个请求 10,000 次操作的限制 | 行为转变 | 确保单个 AddBatchJobOperations 请求包含的操作不超过 10,000 个。 |
在 ListBatchJobResultsRequest 中将页面大小默默限制为 1,000 |
返回 INVALID_PAGE_SIZE 错误 |
行为转变 | 确保 ListBatchJobResultsRequest.page_size 设置为 1,000 或更小的值，因为现在请求更大的页面大小会导致错误。 |
| 效果最大化广告系列 | |||
| 素材资源效果标签 | 无 | 移除 | 我们已针对效果最大化广告系列移除了素材资源效果标签支持和关联的效果标签枚举。相应地更新集成。 |
Campaign.url_expansion_opt_out |
AssetAutomationSetting 中的 FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION 标志 |
移除 / 更换 | 使用“最终到达网址扩展文字素材资源自动化”设置。移除了广告系列级网址扩展选择停用字段。 |
| 规划 | |||
views |
trueview_views |
移除 / 更换 | 将对 views 的引用替换为 ReachPlanService 中的新 trueview_views 字段。 |
| 视频 | |||
average_cpv video_view_rate video_views video_view_rate_in_feed video_view_rate_in_stream video_view_rate_shorts |
trueview_average_cpv video_trueview_view_rate video_trueview_views video_trueview_view_rate_in_feed video_trueview_view_rate_in_stream video_trueview_view_rate_shorts |
重命名 | 更新查询字符串和集成，以使用表示 TrueView 视频观看次数的新指标名称。 |
功能和更新（非破坏性）
| 功能和更新 | 类型 | 说明 |
|---|---|---|
| 素材资源 | ||
AssetFieldType.LANDING_PAGE_PREVIEW |
新枚举值 | 添加为新的图片素材资源字段类型。 |
AssetGenerationService |
新服务（Beta 版） | 允许使用生成式 AI 生成文本和图片素材资源：
|
| 广告系列 | ||
AppCampaignBiddingStrategyGoalType |
新枚举值 | 为应用安装广告系列 (ACi) 添加了新的目标，以便在不指定目标的情况下进行优化：
|
BiddingStrategyType |
新功能 | 新增了对“固定广告占有率”出价策略类型的支持。 |
Campaign.feed_types |
新字段 | 显示附加到广告系列的 Feed 类型。对于效果最大化广告系列，此参数可以指明业务垂直行业，例如 MERCHANT_CENTER_FEED 表示零售。 |
| 共享集定位 | 新功能 | 允许将否定关键字共享集附加到多渠道（针对应用广告系列）和本地广告系列。 |
| 需求开发 | ||
| “目标每次点击费用”出价策略 | 新功能 | 添加了出价策略，以在目标每次点击费用下尽可能争取更多点击次数：使用 Campaign.target_cpc 设置广告系列级目标每次点击费用，并使用 AdGroup.target_cpc_micros 在广告组级进行替换。 |
AssetAutomationType.GENERATE_DESIGN_VERSIONS_FOR_IMAGES |
新枚举值 | 如果为 DemandGenMultiAssetAdInfo 启用此功能，系统会添加设计元素并将文字素材资源嵌入到图片素材资源中，以创建具有不同宽高比的新图片素材资源（默认启用）。 |
AssetAutomationType.GENERATE_VIDEOS_FROM_OTHER_ASSETS |
新枚举值 | 如果为 DemandGenMultiAssetAdInfo 启用了此功能，它会使用图片和文字等其他素材资源生成视频，然后可用于创建新的 DemandGenVideoResponsiveAdInfo 实例（默认启用）。 |
| 常规 | ||
ListBatchJobResultsRequest 页面大小回退 |
行为变化 | 如果未设置 page_size 或将其设置为 0，则现在默认设置为最大值 1,000（之前返回 INVALID_PAGE_SIZE）。 |
QuotaError |
新枚举值 / 错误 | 添加了 PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED，以指明何时超出支付资料激活速率限制。 |
| 效果最大化广告系列 | ||
| 素材资源自动化设置 | 新枚举值 | 添加了新的效果最大化广告系列素材资源自动化选项：
|
| 效果最大化广告系列报告细分 | 新细分 | 新增了效果最大化广告系列特有的细分：
|
| 规划 | ||
| 客户关系管理合作伙伴数据名单 | 新功能 / 枚举值 | 为 CRM 数据源添加了 THIRD_PARTY_PARTNER_DATA，以及合作伙伴受众群体验证错误代码（例如服务条款接受情况、链接缺失等）。 |
| 直播创作者指标 | 新字段 | 添加了由创作者数据分析返回的 YouTubeMetrics.is_active_live_stream_creator，用于指示创作者是否在过去 90 天内发布过直播。 |
| 可规划的 CRM 源元数据 | 新信息 | 在 ReachPlanService.ListPlannableUserLists 返回的 PlannableUserList 中添加了 PlannableUserListMetadata，以显示 CRM 数据源类型。 |
| TrendInsight 支持显示相关视频和创作者 | 新字段 | 在 TrendInsight 中添加了对 related_videos 和 related_creators 的支持，并在 video_properties 和 publish_date 中添加了观看属性。 |
| 改进了 InsightsFinder | 新功能 | GenerateInsightsFinderReport 现在支持 parental_status、income_ranges 以及更复杂的 AND/OR 定位组合。 |
| 报告 | ||
| 新的点击类型 | 新枚举值 | 添加了 CLICK_TO_MESSAGE_THIRD_PARTY_CLICK 和 CLICK_TO_MESSAGE_LANDING_PAGE_CLICK。 |
| AssetGroupAsset 细分 | 支持新的细分 | AssetGroupAsset 现在可按 device、conversion_action、conversion_action_name 和 conversion_action_category 进行细分。 |
| AdGroupAdAssetView 中的自适应搜索广告 | 新功能 / 指标支持 | AdGroupAdAssetView 现在完全支持 RESPONSIVE_SEARCH_AD 的效果和转化指标（之前仅返回展示次数）。 |
| 探索查询聚类指标细分 | 支持新的细分 | 指标 clicks_unique_query_clusters、conversions_unique_query_clusters 和 impressions_unique_query_clusters 现在可按日期字段进行细分。 |
| TargetingExpansionView | 新的报告资源 | 添加了 TargetingExpansionView，用于报告手动定位的扩展指标，例如 AI Max 搜索广告系列的无关键字扩展。 |
| 购物 | ||
| 购物范围修正 | bug 修复 | 修复了 ShoppingProduct 资源中指标的广告系列和广告组范围。 |
| 统一目标 | ||
| “客户留存”目标 | 新功能 | 添加了对客户留存目标的支持，以便针对重新吸引现有客户进行优化（例如，将 target_option 与 TARGET_SPECIFIC 或 TARGET_ALL 搭配使用）。 |
| 视频 | ||
| 视频观看时长指标 | 新字段 | 添加了观看时长指标：video_watch_time_duration_millis（总时长）和 average_video_watch_time_duration_millis（每次展示的平均时长）。 |
v21 主要版本和次要版本
Google Ads API v21 包含以下新功能、更新和重大变更。
v21.2 (2026-06-24)
Google Ads API v21.2 中添加了以下新功能和更新。v21.2 等次要版本不包含重大更改。
| 功能和更新 | 类型 | 说明 |
|---|---|---|
| 常规 | ||
| 多方审批 | 新功能 |
添加了对多方审批 (MPA) 审核的支持：
|
v21.1（2026 年 2 月 25 日）
Google Ads API v21.1 中添加了以下新功能和更新。v21.1 等次要版本不包含重大更改。
| 功能和更新 | 类型 | 说明 |
|---|---|---|
| 账号管理 | ||
Customer.contains_eu_political_advertising |
新字段 | 检索账号级声明状态，即账号是否包含面向欧盟的政治广告，并返回 EuPoliticalAdvertisingStatusEnum。 |
| 广告系列 | ||
Campaign.missing_eu_political_advertising_declaration |
新字段 | 支持查询和过滤缺少以下声明的广告系列：是否包含面向欧盟的政治广告。 |
v21 (2025-08-06)
Google Ads API v21（一个主要版本）中新增了以下功能、更新和重大变更。
如需相关指导，请参阅升级到最新版本。
破坏性更改
| 初始状态 | 新状态 | 更改类型 | 实现方案指导 |
|---|---|---|---|
| 广告系列 | |||
返回 CriterionError.INVALID_LISTING_GROUP_HIERARCHY |
返回 CriterionError.LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION |
错误代码变更 | 对于启用了部分失败的请求，请处理新的错误代码，而不是原始的层次结构错误代码。 |
| 转化次数 | |||
在 ConversionUploadService 中使用 debug_enabled 模式 |
无 | 移除 | 移除了 debug_enabled 字段。更新引用该参数的代码，使其不再设置或查询该参数。 |
| 欧盟政治广告变更 | |||
| 欧盟政治广告的可选广告系列自我声明 | 新广告系列的必需 contains_eu_political_advertising 字段 |
验证规则 / 行为变化 | 如果未设置此字段，则创建新广告系列的 API 调用将失败，并显示 FieldError.REQUIRED 错误。自 2025 年 9 月 22 日起，声明为 CONTAINS_EU_POLITICAL_ADVERTISING 的广告系列将无法在欧盟境内投放。 |
| 无需自我声明即可修改的条件 | 使用 CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION 导致更新失败 |
验证规则 / 行为变化 | 在尝试为现有广告系列创建或更新广告系列级或广告组级邻近区域、地理位置或地理位置组定位条件之前，请先设置自我声明状态。 |
| 没有自行声明要求的实验 | 使用 ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION 导致更新失败 |
验证规则 / 行为变化 | 确保已在实验的广告系列中完成自我声明。 |
| 效果最大化广告系列 | |||
brand_guidelines_enabled 默认值为 false |
默认设置为 true |
行为转变 | 对于新的效果最大化广告系列，系统会默认启用品牌规范。如果应停用这些功能，请将相应字段明确设置为 false。 |
| 规划 | |||
AudienceInsightsService.GenerateTargetingSuggestionMetrics 的原始输入实参类型 |
类型为 InsightsAudience 的输入 |
类型变更 | 更新了实现，以传递新的输入类型，该类型支持用户兴趣的“或”组合的“与”组合，从而允许自定义受众群体定义使用潜在覆盖面指标。 |
功能和更新（非破坏性）
| 功能和更新 | 类型 | 说明 |
|---|---|---|
| AI Max 搜索广告系列 | ||
Campaign 中的 ai_max_setting.enable_ai_max |
新字段 | 启用 AI Max 以扩大搜索字词匹配范围（在切换为关闭状态之前，会沿用之前的文案素材资源自动化和品牌列表设置）。字段 Campaign.ai_max_setting.bundling_required 用于指明是否必须启用 AI Max 才能遵循/修改这些设置，而 AdGroup.ai_max_ad_group_setting.disable_search_term_matching 可在广告组级停用匹配。请参阅利用 AI Max 搜索广告系列，助力广告效果再创新高。 |
CampaignError.AI_MAX_MUST_BE_ENABLED |
新枚举值 / 错误 | 在搜索广告系列中选择启用网址扩展文案适配功能，但未启用 AI Max 时抛出。 |
| 广告组级定位 | 新功能 | 在 AI Max 搜索广告系列中添加了对广告组级品牌名单、地理位置和网页（网址规则）的支持。 |
ai_max_search_term_ad_combination_view |
新的报告资源 | 报告搜索字词、标题和着陆页组合的效果。 |
search_term_match_type 细分 |
新枚举值 | 添加了AI_MAX作为搜索字词匹配类型选项。 |
| 素材资源 | ||
PromotionAsset |
新字段 | 添加了 terms_and_conditions_text、terms_and_conditions_uri 和 oneof promotion_trigger 选项（promotion_barcode_info、promotion_qr_code_info）。请参阅促销信息素材资源简介。 |
AssetAutomationType.FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION |
新枚举值 | 已添加到 AssetAutomationType，用于控制搜索广告系列中最终到达网址的自动文字和着陆页生成功能。 |
AutomaticallyCreatedAssetRemovalService.RemoveCampaignAutomaticallyCreatedAsset |
新服务 / 方法 | 允许从广告系列中移除自动制作的最终到达网址扩展素材资源。 |
ServedAssetFieldType.DESCRIPTION_PREFIX |
新枚举值 | 添加此项是为了修正 ad_group_ad_asset_combination_view 中将类型返回为 UNKNOWN 的报告问题。 |
| 广告系列 | ||
CampaignPrimaryStatusReason.MISSING_LOCATION_TARGETING |
新枚举值 | 如果受地理位置限制的广告系列缺少地理位置定位（如果定位到允许的区域以外，现在会抛出 LOCATION_TARGETING_NOT_ELIGIBLE_FOR_RESTRICTED_CAMPAIGN），则返回此错误。 |
| 第三方应用分析工具集成 | 新字段 | 添加了对 VideoCustomer.third_party_integration_partners 和 Campaign.third_party_integration_partners 的支持。请参阅使用第三方应用分析工具跟踪应用转化情况。 |
Campaign.advertising_partner_ids |
新字段支持 | 现在，可以为现有广告系列设置该字段（设置后保持不变）。 |
| 经理账号级排除的展示位置 | 新功能 | 允许使用 CustomerNegativeCriterion 在各个广告客户账号中排除展示位置列表。 |
| “目标广告支出回报率”策略中的容差配置 | 新字段 | 在 MaximizeConversionValue 和 TargetRoas 中添加了对 TargetRoas.target_roas_tolerance_percent_millis（适用于搜索广告系列组合出价策略）的支持。 |
LocationInterestView |
新的报告资源 | 汇总了广告组地理位置兴趣条件的效果。 |
| 转化次数 | ||
conversion_attribution_event_type 细分 |
新枚举值 | 为转化归因类型选项添加了 ENGAGED_VIEW。 |
| 需求开发 | ||
CampaignBudgetError.BUDGET_BELOW_DAILY_MINIMUM |
新枚举值 / 错误 | 添加了此功能，以便为强制执行需求开发广告系列的每日最低预算做好准备。详细信息通过 budgetDailyMinimumErrorDetails 公开。 |
| 效果最大化广告系列 | ||
campaign_search_term_view |
新的报告资源 | 在广告系列一级汇总搜索字词指标，以便对效果最大化广告系列进行搜索字词分析和报告。 |
| 规划 | ||
ReachPlanService.ListPlannableUserInterests |
新方法 | 允许发现 generateReachForecast 的可规划的兴趣相似的受众群体和有购买意向的受众群体。 |
AdditionalApplicationInfo |
新字段 | 已在 ReachPlanService.ListPlannableUserLists 中添加为可选输入。 |
| AudienceInsights 属性列表 | 新功能 | AudienceInsightsService.ListAudienceInsightsAttributes 现在会提取可用的第一方用户名单。 |
| AudienceCompositionInsights 定位 CRM 列表 | 新功能 | AudienceInsightsService.GenerateAudienceCompositionInsights 现在会针对 AudienceInsightsDimension 维度（AGE_RANGE、GENDER、AFFINITY_USER_INTEREST 和 IN_MARKET_USER_INTEREST）返回用户名单索引详细信息。 |
TrendInsightMetrics 受众群体份额 |
新字段 | 表示趋势的受众群体份额。 |
KnowledgeGraphAttributeMetadata 个类别 |
新字段 | 按匹配的类别过滤知识图谱属性。 |
| 报告 | ||
| 素材资源观看指标 | 新功能 / 指标 | 为 AssetGroupAsset、ChannelAggregateAssetView 和 CampaignAggregateAssetView 添加了多项新指标。效果最大化广告系列现在还会报告 impressions 的真实值。 |
| 选择器扩展 | 新功能 | 使 AssetSet 和 CampaignAssetSet 可在 ChangeStatus 中一起查询。 |
search_term_targeting_status |
新建细分受众群 | 广告系列搜索字词视图中的可选择细分。 |
final_url_expansion_asset_view |
新的报告资源 | 报告最终到达网址扩展素材资源的效果详情。 |
| AssetGroup 价值调整 | 新字段 | 在 AssetGroup 报告中添加了对 value_adjustment 和 all_value_adjustment 指标的支持。 |
landing_page_source |
新建细分受众群 | 在 landing_page_view 中提供着陆页来源细分。 |
search_term_match_source |
新建细分受众群 | 搜索字词视图和广告系列搜索字词视图中的可选细分。 |
match_type |
新建细分受众群 | 关键字视图中可选择的细分键。 |
| 唯一身份搜索查询意图聚类报告 | 新字段 | 添加了 clicks_unique_query_clusters、conversions_unique_query_clusters 和 impressions_unique_query_clusters，用于报告唯一查询 intent 集群。 |
ClickType.VEHICLE_ASSETS |
新枚举值 | 在 click_view 报告中跟踪和报告与车辆广告格式相关的点击。 |
| 智能出价探索 | ||
| 搜索策略中的容差配置 | 新字段 / 设置 | 允许通过将 target_roas_tolerance_percent_millis 设置为介于 10,000（10%）和 30,000（30%）之间（含这两个值）来在搜索广告系列中启用智能出价探索功能（“尽可能提高转化次数”出价策略需要 target_roas 设置）。请参阅我们关于智能出价探索的博文和帮助中心文章。 |
| 多元化报告兼容性 | 新功能 | 现在，对于唯一查询意图聚类，支持以下指标的汇总多样性报告。Google Ads 界面中提供按时间段细分的视图：
|
| 视频 | ||
YouTubeVideoListAsset |
新资源 / 字段 | 允许使用 Asset.youtube_video_list_asset 在广告系列和视频列表素材资源之间建立关联。请参阅使用相关视频。 |
| 分析洞见元数据扩展 | 新字段 | 向 YouTubeChannelInsights 和 YouTubeVideoAttributeMetadata 添加了新的元数据。 |
| 互动点击类型 | 新枚举值 | 添加了点击类型：VIDEO_RELATED_VIDEOS_CLICK、VIDEO_CHANNEL_CLICK 和 PRODUCT_ASSETS。 |
VideoAdInventoryControl.allow_non_skippable_in_stream |
新字段 | 允许视频自适应广告以不可跳过的插播广告的形式投放，以用于混合使用可跳过和不可跳过格式的广告系列。 |
| 视频依序展示设置 | 新字段 | 添加了只读的排序配置：Campaign.VideoCampaignSettings.video_ad_sequence 和 VideoAdSequenceStepSetting。请参阅视频广告依序展示简介。 |
| 视频频道组定位 | 新条件类型 / 字段 | 在 CampaignCriterion 和 AdGroupCriterion 中添加了 VIDEO_LINEUP 条件类型和相应字段。此功能仅适用于已列入许可名单的账号。 |
| 内容适宜性展示位置的观看次数 | 新的报告资源 | 添加了内容适宜性报告，包括详细信息级 (detail_content_suitability_placement_view) 和分组级 (group_content_suitability_placement_view) 报告。请参阅“内容适宜性”报告简介。 |
归档版本说明
如需查看归档的版本说明，请参阅已停用的版本。