版本说明

如需查看当前和计划弃用的功能的最新列表，请参阅功能弃用。

v26 主要版本

Google Ads API v26 包含以下新功能、更新和破坏性更改。

v26 (2026-10-14)

Google Ads API v26 是一个主要版本，其中添加了以下新功能、更新和破坏性更改。

如需相关指导，请参阅升级到最新版本。

破坏性更改

初始状态 新状态 更改类型 实现方案指导
广告系列
LocalServicesPmaxCampaignSettings 中的可选 country_code 字段 制作本地生活服务效果最大化广告系列 (LocalServicesPmaxCampaignSettings.country_code) 期间的必填字段 行为转变 制作本地服务效果最大化广告系列时，请务必指定 country_code（以及新要求的 listing_id）。
转化次数
ConversionTrackingSetting (Customer.conversion_tracking_setting) 中的 enhanced_conversions_for_leads_enabled 字段 无 移除 请改为在 Customer.conversion_tracking_setting 上使用 ConversionTrackingSetting.enablement_setting 来检查账号级增强型转化设置。
定位
AdGroupBidModifier 中的酒店专用条件字段：
  • hotel_date_selection_type
  • hotel_advance_booking_window
  • hotel_length_of_stay（min_nights 和 max_nights）
  • hotel_check_in_day
  • hotel_check_in_date_range
 AdGroupBidModifier 中的不限行业的条件字段： 重命名 / 移除 更新引用，以使用不限行业的条件字段，这些字段支持定位到酒店以外的旅游行业（例如推荐活动）。条件 ID、定位行为和现有出价调节系数保持不变。min_nights 和 max_nights 的值会原封不动地沿用到 min_days 和 max_days。
HotelDateSelectionType 和 segments.user_set_dates 的类型 DateSelectionType 重命名 / 类型更改 不过，应使用 DateSelectionType 代替 HotelDateSelectionType。
CriterionError 中特定于酒店的错误原因：
  • HOTEL_LENGTH_OF_STAY_OVERLAPS_WITH_EXISTING_CRITERION
  • HOTEL_ADVANCE_BOOKING_WINDOW_OVERLAPS_WITH_EXISTING_CRITERION
  • HOTEL_CHECK_IN_DATE_RANGE_OVERLAPS_WITH_EXISTING_CRITERION
  • HOTEL_CHECK_IN_DATE_RANGE_START_DATE_TOO_EARLY
  • HOTEL_CHECK_IN_DATE_RANGE_END_DATE_TOO_LATE
  • HOTEL_CHECK_IN_DATE_RANGE_REVERSED
 CriterionError 中与垂直无关的错误原因： 重命名 更新了错误处理，以检查新的与垂直行业无关的错误原因。

功能和更新（非破坏性）

功能和更新 类型 说明
素材资源
LINE 和短信型商家私信提供商 新字段和枚举值 在 BusinessMessageAsset 中添加了对 LINE 和短信作为消息提供方的支持，包括新字段 BusinessMessageAsset.line_info 和 BusinessMessageAsset.sms_info 以及 BusinessMessageProvider.LINE 和 BusinessMessageProvider.SMS。
AssetGroupError.UNSUPPORTED_LOCAL_SERVICES_CATEGORY 新枚举值 / 错误 已添加到 AssetGroupError，用于指明本地服务效果最大化广告系列不支持 GoogleLocalServicesInfo (AssetGroup.google_local_services_info) 中指定的类别。
广告系列
制作本地生活服务效果最大化广告系列 新功能、字段和错误

将 PmaxCampaignSettings.local_services_enabled 从 OUTPUT_ONLY 更新为 IMMUTABLE，允许外部 API 客户端在制作新的本地生活服务效果最大化广告系列时指定 local_services_enabled = true。

还添加了 LocalServicesPmaxCampaignSettings.listing_id 以公开与本地服务效果最大化广告系列相关联的 Google 商家资料商家信息 ID（在本地服务效果最大化广告系列制作期间标记为必需），并添加了 CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID 错误代码。
本地生活服务广告系列验证错误 新枚举值和错误 添加了针对本地生活服务广告系列的新验证错误：
Hotel Center 账号关联验证 新枚举值 / 错误 在 CampaignError 中添加了 CampaignError.HOTEL_PROPERTY_ASSET_SET_HOTEL_CENTER_LINK_REQUIRED 错误代码，以表明将酒店房源素材资源集 (Campaign.hotel_property_asset_set) 与指定旅行目标的效果最大化广告系列相关联需要有效的 Hotel Center 账号关联。
需求开发广告系列的最低每日预算 新字段 向 CurrencyConstant 添加了 demand_gen_info.minimum_budget_per_day_micros 字段，用于指定需求开发广告系列以该币种结算时所需的每日最低预算。当 API 强制执行的最低预算发生变化时，此字段的值会更新。
广告系列的提升效果评测配置 新字段 添加了 Campaign.lift_measurement_config，以公开与广告系列关联的提升效果评测配置的资源名称。
AI Max 实验验证 新枚举值 / 错误 尝试为已启用 AI Max 的广告系列（或在创建实验组之前在同一请求中启用的广告系列）创建 ADOPT_AI_MAX 实验时，向 ExperimentArmError 添加了 ExperimentArmError.ADOPT_AI_MAX_CAMPAIGN_ALREADY_ENABLED 错误代码。
购物广告系列商品详情类型 扩展支持 扩大了 Campaign.listing_type 对购物广告系列的支持。
欧盟政治广告自行声明更新 更新后的行为和新字段

对于未明确定位到欧盟的某些广告系列，Campaign.contains_eu_political_advertising 现在是可选的。

  • 除非DEMAND_GEN广告系列（采用升级版定位）另有说明，否则如果广告系列在执行请求后满足以下所有条件，则该字段为可选字段：
    • 不包含欧盟境内的任何肯定地理位置广告系列定位条件
    • 不包含肯定邻近区域或营业地点组广告系列条件
    • 包含至少一个欧盟境外的正地理位置广告系列定位条件
  • 对于 DEMAND_GEN 广告系列，如果广告系列中的每个有效广告组在请求执行后都满足以下所有条件，则 upgraded_targeting 字段为可选字段：
    • 不包含欧盟境内的肯定地理位置广告组条件
    • 不包含任何肯定邻近性或营业地点组广告组条件
    • 包含至少一个位于欧盟境外的肯定地理位置广告组条件
    对于没有有效广告组的广告系列，此字段也是可选的。如果请求创建的广告组不符合这些条件，则会返回 AdGroupError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION。
  • 这些更改将同时应用于新广告系列和现有广告系列。在某些情况下，只有在同一请求中添加了条件时，才能制作新广告系列 - 使用 GoogleAdsService.Mutate 对更改进行分组。
  • 更新了 Campaign.missing_eu_political_advertising_declaration 以匹配对 Campaign.contains_eu_political_advertising 的更改。
  • 添加了 GeoTargetConstant.require_eu_political_advertising_declaration，用于指明地点是否位于欧盟境内。
  • 添加了 CampaignCriterion.require_eu_political_advertising_declaration 和 AdGroupCriterion.require_eu_political_advertising_declaration，如果相应广告系列中存在任何广告系列级条件（或在采用升级版定位功能的 DEMAND_GEN 广告系列中存在任何有效的广告组级条件），则必须提供 Campaign.contains_eu_political_advertising（如果此字段为 true）。如果条件的 negative 字段为 false，并且条件是欧盟境内的地理位置、邻近区域（无论是否与欧盟领土重叠）或营业地点组（无论是否与欧盟领土重叠），则这些字段会返回 true。
转化次数
统一的增强型转化配置 新字段和枚举 添加了 ConversionTrackingSetting.enablement_setting 和 ConversionTrackingSetting.effective_enablement_setting（在 Customer.conversion_tracking_setting 上），以公开账号的统一增强型转化配置，该配置使用新的 EnhancedConversionsConfig 枚举表示。
ConversionActionCategory.MESSAGE_LEAD 新枚举值 已添加到 ConversionActionCategory，以支持表示对广告客户的产品/服务感兴趣的消息或聊天互动。
ConversionAttributionEventType.CLICK 新枚举值 已添加到 ConversionAttributionEventType，用于表示归因于广告点击的转化，这些转化之前包含在 UNKNOWN 枚举值中。
常规
本地生活服务潜在客户更新 新字段和枚举值
建议
搜索广告的提高预算建议 新建议 添加了 RecommendationType.RAISE_BUDGET_PERFORMANCE_TOO_LOW、Recommendation.raise_budget_performance_too_low_recommendation 和 ApplyRecommendationOperation.raise_budget_performance_too_low，以便在搜索广告系列的每日预算过低时支持提高预算。
报告
搜索次数提升情况评测 新功能、资源、细分和指标 添加了对搜索次数提升情况评测的支持：
购物广告系列的最终到达网址扩展素材资源视图 扩大支持范围 扩展了 final_url_expansion_asset_view，以支持购物广告系列（ad_group 可与 final_url_expansion_asset_view.ad_group 一起作为归因资源进行选择）。
视频
YouTube 生成式内容披露声明 新字段和枚举 添加了对 YouTube 上传内容的生成式内容披露信息的支持。YouTubeVideoUpload 中添加了类型为 VideoContentMetadata 的新字段 YouTubeVideoUpload.video_content_metadata，其中包含类型为 YouTubeVideoUploadGenerativeContentDisclosure 的 VideoContentMetadata.generative_content_disclosure 下的披露设置。

v25 主要版本和次要版本

Google Ads API v25 包含以下新功能、更新和破坏性更改。

v25.2 (2026-09-23)

Google Ads API v25.2 中添加了以下新功能和更新。次要版本（例如 v25.2）不包含破坏性更改。

功能和更新 类型 说明
素材资源
“AssetGroup”的网址选项 新字段 为 AssetGroup 添加了对网址选项的支持，让广告客户能够在素材资源组一级指定跟踪模板、自定义参数和最终到达网址后缀：
广告系列
自动视频抓取信息 新字段和枚举 向 Campaign.AssetAutomationSetting 添加了 AutomatedVideoCrawlSetting 以及 AssetAutomationType.AUTOMATED_VIDEO_CRAWL，以便您为效果最大化广告系列指定自动视频抓取设置。AutomatedVideoCrawlSetting.automated_video_crawl_infos 包含一个 AutomatedVideoCrawlInfo 条目的列表，每个条目都配置了抓取 url、source_platform（VideoCrawlSourcePlatform：LANDING_PAGE、SOCIAL 或 YOUTUBE）和 enabled 选择启用状态。
客户生命周期优化价值调节系数错误 新枚举值和错误 添加了在为客户生命周期优化配置价值调节系数（value_multiplier 和 high_lifetime_value_multiplier）时出现的新验证错误原因：
SmartCampaignSettingService.GeneratePMaxDraftCampaign 新功能 添加了 SmartCampaignSettingService.GeneratePMaxDraftCampaign，以支持从现有智能广告系列生成效果最大化广告系列草稿，并使用 CampaignStatus.PAUSED 状态和 CampaignCreationStatus.INCOMPLETE 创建状态进行初始化（请参阅将智能广告系列转换为效果最大化广告系列）：
转化次数
Firebase 广告展示次数 新的转化操作类型和类别 公开了 FIREBASE_ANDROID_APP_AD_IMPRESSION 和 FIREBASE_IOS_APP_AD_IMPRESSION 转化操作类型，以便您检索和修改这些转化操作。此外，还在 ConversionActionCategory 中公开了 IN_APP_AD_REVENUE 类别，以跟踪应用内广告变现收入。
常规
BusinessProfileLocationSyncError 新枚举和错误 添加了在 LOCATION_SYNC 类型的 AssetSet 中同步营业地点时出现商家资料营业地点同步错误的原因。现在，API 不会返回一般性 UNKNOWN 错误，而是会返回 BusinessProfileLocationSyncError，并附带具体原因（EMAIL_INVALID、OAUTH_TOKEN_INVALID、ACCOUNT_REMOVED 和 NO_PERMISSION_TO_ACCESS_LOCATION_ACCOUNT）。
规划
BenchmarksService.GenerateBenchmarksMetrics 百分位指标 新功能

更新了 BenchmarksService.GenerateBenchmarksMetrics，以百分位层级格式提供代表客户在其他广告客户中的竞争地位的指标。指标在新的 CustomerMetrics.percentile_metrics 字段（GenerateBenchmarksMetricsResponse.customer_metrics 和 BreakdownMetrics.customer_metrics 上）中以 PercentileMetrics 形式返回，并使用 BenchmarksCustomerPercentileTier 表示。

只有当 GenerateBenchmarksMetricsRequest 中同时满足以下两个条件时，才会填充 CustomerMetrics.percentile_metrics：

为 ListBenchmarksAvailableDatesResponse.supported_dates 内的未结季度日期（由 BenchmarksService.ListBenchmarksAvailableDates 返回）添加了对百分位指标的支持。虽然客户汇总指标 (CustomerMetrics.aggregate_metrics)、客户比率指标 (CustomerMetrics.average_rate_metrics) 和客户百分位指标 (CustomerMetrics.percentile_metrics) 在 supported_dates 中的所有日期（包括未结季度）都受支持，但客户份额指标 (CustomerMetrics.share_metrics) 和基准来源的比率指标（average_benchmarks_metrics，例如“/服装/服装”广告的 average_cpm）不受未结季度支持，并且会从响应中省略，除非所请求的 date_range 落在较窄的 ListBenchmarksAvailableDatesResponse.supported_dates_for_all_metrics 范围内。

添加了自定义 BenchmarksError.NO_METRICS_FOUND 错误，用于指示未找到所选输入组合的任何指标，以提高易用性。
YouTube 频道标识名，用于获取创作者数据分析 新功能 更新了 ContentCreatorInsightsService.GenerateCreatorInsights，以支持使用 YouTubeChannels.youtube_channel_handles 按 YouTube 频道标识名进行搜索（有效的频道标识名必须以 @ 开头，例如 @channel_handle）。此选项类似于按 YouTube 频道 ID 进行搜索。回答包含有关所请求 YouTube 创作者的数据洞见。
建议
每次转化费用和广告支出回报率出价建议 新建议 添加了 Recommendation.raise_target_cpa_performance_bid_too_low_recommendation (RAISE_TARGET_CPA_PERFORMANCE_BID_TOO_LOW) 和 Recommendation.lower_target_roas_performance_bid_too_low_recommendation (LOWER_TARGET_ROAS_PERFORMANCE_BID_TOO_LOW)，以及 ApplyRecommendationOperation.raise_target_cpa_performance_bid_too_low 和 ApplyRecommendationOperation.lower_target_roas_performance_bid_too_low，以便在出价过低导致搜索广告系列无法进入竞价时，支持提高目标每次转化费用或降低目标广告支出回报率：
报告
酒店行程维度细分 新建细分 在 Segments 中添加了以下酒店和旅游预订行程维度细分（可通过 campaign、ad_group 和 customer 选择）：
竖屏广告指标 新指标 向 Metrics 添加了以下酒店和旅游垂直行业广告报告指标（可通过 campaign、ad_group 和 customer 选择）：
竖屏广告细分 新建细分 为酒店和旅游行业广告报告添加了以下细分维度，这些细分维度可报告给 Segments（可通过 campaign、ad_group 和 customer 选择）：

v25.1 (2026-08-19)

Google Ads API v25.1 中添加了以下新功能和更新。次要版本（例如 v25.1）不包含破坏性更改。

功能和更新 类型 说明
素材资源
AssetFieldType.TEXT_DISCLAIMER
ServedAssetFieldType.TEXT_DISCLAIMER		 新枚举值 添加了对文字免责声明素材资源的支持。
广告系列
Campaign.aca_migration_date_time
Campaign.broad_match_migration_date_time		 新字段 跟踪即将进行的自动迁移到 AI Max 的情况。
转化次数
品牌提升效果评测 新功能 添加了对品牌提升效果评测的支持，并进行了以下更新：
转化量提升效果评测 新功能 添加了对转化量提升效果评测的支持，并进行了以下更新：
LiftMeasurementFlight 新建资源 一种新的只读资源，表示提升效果评测配置的排期详情，包括评测排期的开始日期和结束日期（start_date 和 end_date）。
常规
SmartCampaignError 新枚举值 为效果最大化广告系列生成限制添加了新的特定错误代码：
AuthorizationErrorEnum.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION 新枚举值 / 错误 当具有 TEST 访问权限级别的 Google Cloud 项目尝试针对非测试账号发出请求时返回。
规划
品牌情绪分析洞见 新功能 在 ContentCreatorInsightsService 中添加了对品牌情感分析洞察的支持：
BenchmarksService 项增强功能 新功能 添加了对类别作为过滤条件的支持，以便限定基准分析的范围。还支持其他关键业务指标：
育儿状况定位 新功能 在覆盖面规划工具中添加了对育儿状况定位的支持。为服务 ReachPlanService.GenerateReachForecast 的 Targeting 添加了新字段 parental_statuses，为服务 ReachPlanService.ListPlannableProducts 的 PlannableTargeting 添加了新字段 parental_statuses。
建议
Recommendation.campaign_specific_app_goal_recommendation 新建议 建议添加专门针对广告系列的应用转化目标。新的 EffectiveAutomaticGoal 资源用于表示相应建议中的当前目标。
报告
Metrics.original_conversion_value 新字段 表示可出价转化的原始转化价值。这是在应用任何价值规则调整项（例如转化价值规则或生命周期目标调整项）之前的未调整转化价值。
忠诚会员统计数据 新功能 添加了对按用户会员资格状态细分统计信息的支持，并为转化价值规则添加了会员资格主要维度：
  • 添加了 Segments.loyalty_membership 细分，以支持按完成转化的用户的会员回馈活动层级对报告指标进行细分。
  • 添加了 LOYALTY_MEMBERSHIP 主维度，用于标识何时满足转化价值规则的会员条件。
定位
vertical_ads_item_bid 新条件类型 向 AdGroupCriterion.criterion 添加了新的 vertical_ads_item_bid 条件类型。

v25 (2026-07-22)

Google Ads API v25（一个主要版本）中添加了以下新功能、更新和破坏性更改。

如需相关指导，请参阅升级到最新版本。

破坏性更改

初始状态 新状态 更改类型 实现方案指导
广告系列
CustomerLifecycleOptimizationValueSettings 中的独立字段 additional_value 和 additional_high_lifetime_value 分别属于 value_adjustment 和 high_lifetime_value_adjustment oneof，以及新的 value_multiplier 和 high_lifetime_value_multiplier 字段 结构性变更 更新对这些字段的引用，因为它们现在是 oneof 的一部分。
旧版 CustomerLifecycleGoal 和 CampaignLifecycleGoal 资源、其对应的服务 CustomerLifecycleGoalService 和 CampaignLifecycleGoalService，以及旧版设置/枚举（CustomerAcquisitionGoalSettings、CustomerAcquisitionOptimizationModeEnum、LifecycleGoalValueSettings） 无 移除 使用经过改进的统一目标架构：
常规
Incentive Service 请求和响应消息中的嵌套枚举字段：
  • FetchIncentiveRequest.type
  • Incentive.type
  • IncentiveOffer.type
 独立枚举字段： 重命名 / 移除 请使用新的独立枚举字段，而不是旧版 type 字段。
ApplyIncentiveRequest 中的可选 selected_incentive_id 和 customer_id 字段 必填字段 行为转变 请确保在调用 ApplyIncentive 时提供这两个字段。
LocalServicesLead 资源中的消费者邮箱字段 ContactDetails.email 无 移除 移除对此字段的引用，因为该字段不再受支持。
AdvertisingPartnerLinkInvitationProperties 中的可选 allowed_domain 字段 为广告合作伙伴调用 CreateProductLinkInvitation 时，此字段为必填字段 行为转变 为广告合作伙伴创建产品关联邀请时，请务必提供 allowed_domain。
规划
GenerateCreatorInsightsRequest 中的 search_brand 字段 无 移除 请改用 search_topics。
Targeting 中的 plannable_location_id 字段和 GenerateReachForecastRequest 中的 cookie_frequency_cap 字段 无 移除 改用 plannable_location_ids 和 cookie_frequency_cap_setting。
报告
GenerateBenchmarksMetricsResponse 和 BreakdownMetrics 中的 customer_metrics 字段，类型为 Metrics 类型为 CustomerMetrics 的字段 类型更改 / 行为转变 请更新您的集成，以使用新的 CustomerMetrics 类型，该类型仅包含代表客户广告效果的指标。

功能和更新（非破坏性）

功能和更新 类型 说明
Ads
AssetAutomationType.GENERATE_ANIMATED_IMAGES_FROM_OTHER_ASSETS 新的枚举值 / 行为 适用于 DemandGenMultiAssetAds。如果启用，它会使用非动画图片作为输入来生成动画图片。从该 API 版本开始，默认情况下会选择启用新的 DemandGenMultiAssetAds。
合成内容信息可变性 行为变更 Asset.synthetic_content_info 和 Ad.synthetic_content_info 现已在 v25、v24 和 v23 中完全可变。
广告系列
“会员留存”目标 新功能 / 设置 新增了对“会员留存”目标的支持，让广告主能够以留住会员为目标来优化广告系列。
“新客户获取”目标 新功能 / 设置 更新了 Google Ads API 中对“新客户获取”目标的支持，以反映经过改进的统一目标架构：
转化次数
YouTube 第三方转化归因 新字段 添加了对使用第三方合作伙伴进行 YouTube 转化归因验证的支持： 如需了解详情，请参阅帮助中心文章。
常规
ContactDetails.phone_number_extension 新字段 已添加到 LocalServicesLead 资源。
IncentiveError 新的枚举值和错误 添加了针对奖励兑换失败的新特定错误代码：
规划
热门趋势中的 YouTube 频道详细信息 新字段 添加了对更多 YouTube 频道相关视频详情的支持，以便在搜索趋势分析时使用。向 YouTubeVideoAttributeMetadata 添加了新字段 channel_id、channel_name 和 channel_url。
YouTubeChannelInsights.data_sharing_consent_given 新字段 已添加到 YouTubeChannelInsights。如果创作者已同意分享非公开数据，则为 true。如果存在，系统会填充以下字段：
报告
ad_sub_format_type 新建细分受众群 按时长提供 YouTube 不可跳过式插播广告的细分数据： 此细分必须始终与 ad_format_type 一起选择。可通过 AdGroup、AdGroupAd、Campaign、Customer、Video 和 VideoEnhancement 进行选择。
视频专用社交指标 新字段 / 指标 添加了视频专属社交指标，以帮助广告客户跟踪 YouTube 上 Shorts 广告的用户互动度（评论、点赞和分享）： 这些功能适用于 AdGroup、AdGroupAd、Asset、Campaign、Customer 和 Video。

v24 主要版本和次要版本

Google Ads API v24 包含以下新功能、更新和破坏性更改。

v24.2 (2026-06-24)

Google Ads API v24.2 中添加了以下新功能和更新。次要版本（例如 v24.2）不包含破坏性更改。

功能和更新 类型 说明
Ads
AssetAutomationType.GENERATE_LANDING_PAGE_TEXT 新枚举值 从着陆页生成要在 DemandGenVideoResponsiveAd 实例（从该 API 版本开始，默认选择启用）的互动面板中显示的文本信息。
素材资源
AssetGroup.google_local_services_info 新字段 添加了对效果最大化广告系列中的本地生活服务广告信息（类别 ID 和宣传信息）的支持。
AssetGroupSignal.local_services_id 新字段 添加了对效果最大化广告系列中本地生活服务广告服务 ID 信号的支持。
AssetGroupSignal.vertical_ads_item_group_rule_list 新字段 添加了此属性，以支持在效果最大化广告系列中通过垂直广告商品组规则从附加的垂直 Feed 中选择商品。此功能仅面向已列入许可清单的账号提供。
AssetGroupErrorEnum.CANNOT_REMOVE_ALL_ASSET_GROUPS_FROM_CAMPAIGN 新枚举值 / 错误 尝试从广告系列中移除所有素材资源组时返回。
AssetGroupSignalErrorEnum.CANNOT_REMOVE_ALL_SIGNALS 新枚举值 / 错误 在尝试从素材资源组中移除所有信号时返回。
广告系列
Campaign.PmaxCampaignSettings.local_services_pmax_campaign_settings
Campaign.PmaxCampaignSettings.local_services_enabled		 新字段 支持识别本地生活服务效果最大化广告系列。
AdGroup.DemandGenAdGroupSettings.DemandGenChannelControls.DemandGenSelectedChannels.maps 新字段 在需求开发广告组的可选渠道中添加了 Google 地图。
CampaignCriterionErrorEnum.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN 新枚举值 / 错误 尝试从本地服务效果最大化广告系列中移除所有地理位置时返回。
SmartCampaignErrorEnum.CREATION_FAILED 新枚举值 / 错误 在尝试制作新的智能广告系列时返回。
转化次数
ConversionOrigin.LOCAL_SERVICES_ADS
ConversionActionType.LOCAL_SERVICES_ADS		 新的枚举值 表示用户点击本地服务广告并致电、发消息或预订广告客户的服务时发生的转化。
实验
COMPARE_CAMPAIGNS
PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION		 新枚举值 添加了对新的 ExperimentType 类型的支持：
  • COMPARE_CAMPAIGNS：适用于在单次实验中比较多个相同或不同类型广告系列的广告系列组合实验和自定义效果最大化广告系列实验。
  • PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION：适用于效果最大化广告系列优化实验，用于测试文案适配和最终到达网址扩展功能。
常规
Asset.synthetic_content_info
Ad.synthetic_content_info		 新字段 包含合成/AI 生成的内容的证明，分为 advertiser_attestation（广告客户直接提供的声明）和 system_attestation（系统自动检测或提供的证明）。

此功能已向后移植到 v23 和 v22。

为了帮助您规划即将开展的 v25 集成工作，我们提前在 v22 及更高版本中引入了用于更改广告客户认证字段的接口。该接口在这些版本中可见，但 synthetic_content_info.advertiser_attestation.status 和 synthetic_content_info.advertiser_attestation.source 在这些版本中将保持不可变。

如果您尝试对其中任一字段发出 mutate 请求，系统会返回以下错误之一：

“尝试更改的字段不可变”或“无法设置字段”。

从 v25 开始，这些字段将完全可变。我们建议您现在就使用该接口来构建和测试内部逻辑，以便在 v25 发布时，您的系统已准备好使用完整的写入功能。
多方授权 新功能 添加了对多方授权 (MPA) 审核的支持：
此功能已向后移植到 v23.3、v22.2 和 v21.2。
IncentiveService.FetchIncentive 行为变更 如果请求中提供的电子邮件地址无效，该方法现在会正常回退到返回默认奖励优惠，而不是抛出 AuthenticationError.INVALID_EMAIL_ADDRESS 错误。
规划
GenerateCreatorInsightsRequest.search_topics 新字段 已添加到 ContentCreatorInsightsService.GenerateCreatorInsights 服务中。此选项用于搜索在 country_locations 中指定的国家/地区讨论某个主题的创作者（仅支持搜索一个国家/地区）。
CREATOR_TOPIC_INSIGHTS 新枚举值 已添加到 InsightsKnowledgeGraphEntityCapabilities，用于表示用于搜索讨论某个主题的创作者的实体。这些实体应在 search_topics 字段中使用。使用 AudienceInsightsService.ListAudienceInsightsAttributes 进行检索。
KnowledgeGraphEntitySearchOptions 新类型 / 选项 包含 ListAudienceInsightsAttributes 中主题的其他搜索选项，包括用于检索作为创作者属性支持的所有主题的选项，以及按功能进行过滤。
GenerateCreatorInsightsRequest.supplemental_data
GenerateTrendingInsightsRequest.supplemental_data		 新字段 ContentCreatorInsightsService 方法的可选输入。提供此字段会在响应中填充其他位置或创作者属性。
local_creator_insights
related_local_creators		 新字段 当 supplemental_data 包含 LOCAL_CREATOR_DATA 枚举时填充。显示在所选国家/地区观看过或位于所选国家/地区，且同意分享位置数据的本地创作者。
GenerateTrendingInsightsRequest.sub_country_locations 新字段 已添加到 ContentCreatorInsightsService.GenerateTrendingInsights，允许使用国家/地区位置和子国家/地区位置搜索趋势分析。
报告
PerformanceMaxPlacementView 细分受众群扩展 通过 ad_network_type 使其可分段。
购物
Campaign.ShoppingSetting.ignore_brand_exclusion_in_shopping_ads 新字段 如果为 true，则购物广告会忽略品牌排除设置。仅支持购物广告系列。
定位
CriterionErrorEnum.CANNOT_TARGET_LANGUAGE 新枚举值 / 错误 在尝试定位到不允许的语言时返回。
视频
DataLink.youtube_link_metadata 新字段 包含 brand_channel_id，用于指定关联的 YouTube 品牌频道的 ID。

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 类型的支持：
  • ADOPT_AI_MAX：用于测试 AI Max 如何利用 Google AI 和广泛匹配关键字，帮助您吸引更多客户。
  • ADOPT_BROAD_MATCH_KEYWORDS：适用于测试广泛匹配关键字如何影响广告展示次数的实验。
  • OPTIMIZE_ASSETS：适用于旨在优化素材资源的自定义实验。
  • PMAX_REPLACEMENT_SHOPPING：适用于测试购物广告系列与效果最大化广告系列相比效果如何的实验。
Experiment.video_experiment 新字段 为包含视频广告系列的现有 YOUTUBE_CUSTOM 实验提供配置支持。
ExperimentArm.asset_testing_info
ExperimentArm.asset_groups
ExperimentArm.performance_max_experiment_arm_info		 新字段 公开了以下字段，以支持实验组中的素材资源测试、素材资源组和效果最大化广告系列设置：
  • asset_testing_info：与实验性广告副本关联的素材资源的详细信息。
  • asset_groups：优化素材资源实验的实验组中的素材资源组列表。
  • performance_max_experiment_arm_info：PMAX_REPLACEMENT_SHOPPING 实验中效果最大化广告系列的设置。
常规
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 新过滤条件 支持在 SharedCriterion 资源的 VerticalAdsItemGroupRuleInfo 中进行过滤。
控制/实验指标 新字段 添加了 7 个核心指标系列（点击次数、展示次数、费用、转化次数、每次转化费用、转化价值、单位费用转化价值）的对照组值（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
DemandGenVideoResponsiveAdInfo 中的可选 videos 和 logo_images 必填字段 行为转变 在制作或更改自适应需求开发视频广告时，请提供 videos 和 logo_images。
VideoResponsiveAdInfo 中的可选 videos、business_name 和 logo_images 必填字段 行为转变 在制作或修改自适应视频广告时，请提供 videos、business_name 和 logo_images。请注意，VideoResponsiveAdInfo 现在是可变的。
广告系列
Campaign.video_brand_safety_suitability 无 移除 广告系列级适宜性控制功能已被移除。品牌保障适宜性仍可在客户一级使用。请改用 Customer.video_brand_safety_suitability。
转化次数
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS 无 移除 “会员注册”用户类别已被移除。移除对它的代码引用。
规划
topic_audience_combinations 的 InsightsAudienceAttributeGroup 类型 common.InsightsAudienceAttributeGroup 类型 行为转变 / 类型变更 必须更新类型化客户端库集成，才能使用新的资源命名空间。
ReachPlanService.ListPlannableProducts 中的 youtube_select_lineups 字段 无 移除 改用 youtube_select_lineup_targeting中的频道组。
ContentCreatorInsightsService.GenerateCreatorInsights 和 GenerateTrendingInsights 中的 is_brand_connect_creator 字段 无 移除 请改为检查创作者是否在 partnership_opportunities 中拥有 CREATOR_PARTNERSHIPS。
KeywordPlanIdeaService.GenerateKeywordForecastMetrics 中的 geo_modifiers 和 biddable_keywords geo_target_constants和keywords 重命名 / 移除 已替换为 CampaignToForecast.geo_target_constants[] 和 ForecastAdGroup.keywords[]。
GenerateKeywordForecastMetrics 中已弃用的关键字方案 / 预测字段 无 移除 移除了以下方案 / 预测字段和类型： 相应地更新集成。
报告
campaign_budget中的 ad_sub_network_type 细分 无 移除 移除了 campaign_budget 资源的 ad_sub_network_type 段。
素材资源视图中的click_type细分 无 移除 从 AdGroupAsset、CampaignAsset 和 CustomerAsset 视图中移除了细分。
视频
ShareablePreviewService.GenerateShareablePreviews中允许部分失败 无部分失败 行为转变 如果请求中的任何 ID 未通过验证，请求将失败并抛出错误。
ShareablePreviewError 旧版代码： MutateErrorEnum.RESOURCE_NOT_FOUND
ShareablePreviewError.TOO_MANY_RESOURCES_IN_REQUEST		 重命名 / 行为转变 针对素材资源组返回的错误代码已修改，以便与广告组广告错误保持一致。更新了验证捕获逻辑。

功能和更新（非破坏性）

功能和更新 类型 说明
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 转化操作类型枚举：
  • GOOGLE_ANALYTICS_4_GENERATE_LEAD
  • GOOGLE_ANALYTICS_4_QUALIFY_LEAD
  • GOOGLE_ANALYTICS_4_CLOSE_CONVERT_LEAD
  • FIREBASE_ANDROID_GENERATE_LEAD
  • FIREBASE_ANDROID_QUALIFY_LEAD
  • FIREBASE_ANDROID_CLOSE_CONVERT_LEAD
  • FIREBASE_IOS_GENERATE_LEAD
  • FIREBASE_IOS_QUALIFY_LEAD
  • FIREBASE_IOS_CLOSE_CONVERT_LEAD
常规
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 及更高版本中引入了用于更改广告客户认证字段的接口。该接口在这些版本中可见，但 synthetic_content_info.advertiser_attestation.status 和 synthetic_content_info.advertiser_attestation.source 在这些版本中将保持不变。

如果您尝试对其中任一字段发出 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		 新功能 新增了对实体、主题和受众群体的自定义“与/或”组合的支持。
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-02-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 新字段 在按主题搜索时，添加了 TrendInsightDataPoint 至 TrendInsights 的历史趋势线信息。
报告
唯一身份用户频次指标 新字段 新增了以下指标，用于报告有多少用户至少看到过您的广告两次、三次、四次、五次或十次：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 新字段 添加了对需求开发自适应视频广告中随播横幅广告的支持。
奖励
添加了“自选”奖励支持：

为了便于以更精细的方式通过程序化方式处理失败，我们将在未来版本中向 IncentivesService 添加更多错误代码。我们建议您关注即将发布的相关公告和版本说明，了解这些新错误代码，确保您的应用能够应对这些新的故障模式。
规划
AudienceInsightsDimension.LIFE_EVENT_USER_INTEREST 新枚举值 允许在GenerateAudienceCompositionInsights、GenerateSuggestedTargetingInsights、GenerateInsightsFinderReport和GenerateCreatorInsights中使用人生大事构建受众群体。

其他 AudienceInsightsService 方法（例如 AudienceInsightsService.GenerateAudienceOverlap 和 AudienceInsightsService.GenerateTargetingSuggestionMetrics）不支持人生大事。
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_list 条件类型，向 SharedCriterion 添加了 vertical_ads_item_group_rule，以允许在包含旅游 Feed 的搜索广告系列中定位商品组。
竖屏广告数据 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 上的音频广告添加了可听性指标，用于报告广告是否可听以及可衡量可听性的展示次数。

归档版本说明

如需查看已归档的版本说明，请参阅已停用的版本。