版本说明

v24.1 (2026-05-13)

v24.1 中添加了以下新功能和更新。

Ads

• 向 DemandGenMultiAssetAd 添加了字段 classic_display_images。这些是自定义上传的图片，无需其他素材资源即可投放，并且不属于自适应广告格式。

常规

• 向 CustomerUserAccess 资源添加了 CustomerUserAccess.passkey_enabled。此只读字段用于指明用户是否已启用通行密钥。

实验

• 添加了对以下新 ExperimentTypeEnum 类型的支持：
  • 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：与广告的实验性副本相关联的素材资源的详细信息。
  • asset_groups：优化素材资源实验的实验组中的素材资源组列表。
  • performance_max_experiment_arm_info：PMAX_REPLACEMENT_SHOPPING实验中效果最大化广告系列的设置。

报告

• 添加了对 mobile_device_platform 段的支持，允许按设备平台（例如 iOS 或 Android）生成细分报告。

• 发布 REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED。

  查询中的日期范围不支持所请求的时间粒度。按天、小时或周细分的指标仅适用于过去 37 个月。

• 添加了以下可用于垂直广告的细分受众群：

  • vertical_ads_listing_user_rating
  • vertical_ads_listing_venue

• 在 VerticalAdsItemGroupRuleInfo 中添加了对按 user_rating、venue 和 event_participant_display_name 进行过滤的支持，以用于 SharedCriterion 资源。

• 新增了对 7 个核心指标系列中的实验指标的支持：

  • Clicks
  • 展示次数
  • 费用
  • 转化次数
  • 每次转化费用
  • 转化价值
  • 单位费用转化价值

  对于每个核心指标系列，系统会提供以下字段：

  • control_metric（例如 Metrics.control_clicks）：对照组中的指标值。
  • metric（例如 Metrics.clicks）：实验组中的指标值。
  • metric_point_estimate（例如 Metrics.clicks_point_estimate）：不同组之间差异的点估计值。
  • metric_margin_of_error（例如 Metrics.clicks_margin_of_error）：差值的边际误差。
  • metric_p_value（例如，Metrics.clicks_p_value）：差值的 p 值。p 值小于或等于 0.05 表示置信度为 95% 或更高。

• 添加了对 Metrics.conversions_absolute_change_point_estimate、Metrics.conversions_absolute_change_margin_of_error 和 Metrics.conversions_absolute_change_p_value 的支持。

定位

• 已将 CANNOT_EXCLUDE_ALL_TARGETS 添加到 CriterionErrorEnum。尝试排除所有受众特征定位时（这是不允许的），系统会返回此错误。

视频

• 将 ZEFR 发布为第三方可见度集成合作伙伴。
• 向 DataLink 资源的 youtube_video 字段添加了 channel_id，以公开与数据链接相关联的 YouTube 频道 ID。

v24 (2026-04-22)

v24 中添加了以下新功能和更新。

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

Ads

以下字段现已成为必填字段：

• 在 DemandGenVideoResponsiveAdInfo 对象中：

  • videos
  • logo_images

• 在 VideoResponsiveAdInfo 对象中：

  • videos
  • business_name
  • logo_images

  VideoResponsiveAdInfo 现在是可变的。

素材资源

• 向 AssetSet 资源添加了 travel_feed_data 字段。借助此新字段，您可以从旅游 Feed 素材资源集读取旅游 Feed 数据，从而公开只读信息，例如 hotel_center_account_id、merchant_center_id、partner_center_id、subset_id 和 travel_feed_vertical_type。

广告系列

• 移除了 Campaign.video_brand_safety_suitability 字段。此控制功能仍可在客户一级使用。请参阅 Customer.video_brand_safety_suitability。
• 添加了 Campaign.view_through_conversion_optimization_enabled 字段，该字段默认为 false，用于在需求开发广告系列和应用广告系列中启用浏览型转化 (VTC) 优化。
• 为效果最大化广告系列启用了性别排除设置。此排除设置现已适用于所有 Google Ads API 版本的效果最大化广告系列。

转化次数

• 添加了对潜在客户发掘转化类型的支持。以下是 v24 中的新 ConversionActionType 枚举：

  • 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

• 移除了 LOYALTY_SIGN_UPS 用户名单客户类型类别。

常规

• 添加了 UserListErrorEnum.DUPLICATE_LOOKALIKE，当尝试创建与现有相似细分受众群完全相同的相似细分受众群 UserList 时，系统会返回此错误。

规划

• 将 InsightsAudience.topic_audience_combinations 类型定义从 InsightsAudienceAttributeGroup 更改为 common.InsightsAudienceAttributeGroup。对于类型化客户端库，这是一项重大变更，需要更新现有集成。

• 从 ReachPlanService.ListPlannableProducts 服务中移除了 youtube_select_lineups 字段。

  用户应改用 youtube_select_lineup_targeting 中的阵容。

• 从 ContentCreatorInsightsService.GenerateCreatorInsights 和 ContentCreatorInsightsService.GenerateTrendingInsights 服务中移除了 is_brand_connect_creator 字段。

  用户应改为寻找提供CREATOR_PARTNERSHIPS选项的创作者，而不是在partnership_opportunities中寻找。

• 向 ReachPlanService.ListPlannableProducts 响应添加了新字段，以包含有关每个可规划产品的更多详细信息。这些字段中的大多数都包含在 ListPlannableProductsResponse 中的新 ProductCoreAttributes 字段内。新增的响应字段包括：

  • ProductMetadata.plannable_product_description
  • ProductCoreAttributes.marketing_objective
  • ProductCoreAttributes.cost_model
  • ProductCoreAttributes.buying_method

• 从 KeywordPlanIdeaService.GenerateKeywordForecastMetrics 中移除了各种字段：

  • CampaignToForecast.geo_modifiers[] 已替换为 CampaignToForecast.geo_target_constants[]。
  • ForecastAdGroup.biddable_keywords[] 已替换为 ForecastAdGroup.keywords[]。
  • CampaignToForecast.keyword_plan_network
  • CampaignToForecast.negative_keywords
  • ForecastAdGroup.max_cpc_bid_micros
  • ForecastAdGroup.negative_keywords
  • BiddableKeyword
  • CriterionBidModifier
  • KeywordForecastMetrics.impressions
  • KeywordForecastMetrics.click_through_rate

报告

• 移除了 campaign_budget 资源的 ad_sub_network_type 段。
• 从 AdGroupAsset、CampaignAsset 和 CustomerAsset 视图中移除了 click_type 细分。
• 添加了新资源 CartDataSalesView。借助该资源，不仅可以按点击的产品细分转化指标，还可以按售出的产品细分转化指标，例如 product_sold_brand 等细分。
• 添加了不可出价的指标，这些指标还包括您的广告系列未以促成这些转化为目标进行积极优化的转化，例如 all_cost_of_goods_sold_micros。 新指标已添加到支持相应可出价指标的所有资源中。
• 向 ShoppingPerformanceView 资源添加了 conversion_attribution_event_type 段。

购物

• 在 ShoppingProduct 资源中添加了对应用广告系列的支持。请注意，应用广告系列不支持 status 和 issues 字段。
• 为购物广告系列引入了基于标记的商品过滤功能，该功能使用逻辑表达式。
  • 添加了 RETAIL_FILTER_BUNDLE 和 RETAIL_FILTER 条件类型。
  • 添加了 RETAIL_FILTER 作为新的 SharedSetType。
  • AdGroupCriterion 现在可以使用 retail_filter_bundle 字段链接到类型为 RETAIL_FILTER 的 SharedSet。
  • SharedCriterion 现在可以使用 SharedSet 中的 retail_filter 字段来定义各个标记规则或表达式。
  • 已将 RETAIL 添加到 ListingGroupFilterListingSource。
  • 向 AssetGroupListingGroupFilter 添加了 RetailFilter 维度。
  • 在 CriterionError 和 AssetGroupListingGroupFilterError 中添加了新的验证错误代码。
  • 此功能仅面向已列入许可名单的用户提供。

视频

• 更新了 ShareablePreviewService.GenerateShareablePreviews，使其不再使用部分失败。如果任何 ID 的请求失败，系统都会抛出错误。返回新的素材资源组错误代码，以与广告组广告错误保持一致：
  • MutateErrorEnum.RESOURCE_NOT_FOUND 而不是 ShareablePreviewError.ASSET_GROUP_DOES_NOT_EXIST_UNDER_THIS_CUSTOMER
  • ShareablePreviewError.TOO_MANY_RESOURCES_IN_REQUEST 而不是 ShareablePreviewError.TOO_MANY_ASSET_GROUPS_IN_REQUEST

v23.2 (2026-03-25)

v23.2 中添加了以下新功能和更新。

素材资源

• 添加了 VideoEnhancement 资源，其中包含特定于增强功能的视频广告信息，例如视频广告是由 Google 生成还是由广告客户提供。如需了解详情，请参阅视频增强功能简介。
• 添加了 AppTopCombinationView 只读资源，以提供有关应用广告系列中效果最佳的素材资源组合的分析洞见。
• 添加了对使用 field_type BUSINESS_LOGO 检索 CustomerAsset 的支持。

广告系列

• 添加了 AdGroupAd.start_date_time 和 AdGroupAd.end_date_time 字段，以便更精细地控制广告系列的日期安排限制。此功能仅适用于部分广告组类型。
• 添加了 HotelSettingInfo.disable_hotel_setting，以允许在需求开发广告系列中停用酒店 Feed。

常规

• 向 CustomerClientLinkError 添加了两个新的错误代码：MAX_CUSTOMER_LIMIT_REACHED 和 ACCOUNT_CREATION_POLICY_VIOLATION。
• 现在，当尝试使用已弃用的 LOYALTY_SIGN_UPS 用户名单客户类型类别时，系统会抛出错误。

规划

• 在 GenerateTrendingInsights 和 GenerateCreatorInsights 中添加了对实体、主题和受众群体的自定义 AND/OR 组合的支持。
• 在 ReachPlanService.GenerateReachForecast 中添加了新的可定位年龄范围，例如 AGE_RANGE_21_44 或 AGE_RANGE_21_49。
• 向 ReachPlanService.ListPlannableProducts 添加了 youtube_select_lineup_targeting，该属性将取代 youtube_select_lineups。目前，这两个字段均已填充。
• 在 ReachPlanSurface 中添加了 IN_STREAM_NON_SKIPPABLE_THIRTY_SECONDS 作为展示平台选项。
• 在 ReachPlanService.GenerateReachForecast 中，为需求开发广告系列的最大点击次数（每次点击费用）出价策略添加了 Forecast 的 clicks。
• 向 ContentCreatorInsightsService.GenerateCreatorInsights 和 ContentCreatorInsightsService.GenerateTrendingInsights 添加了 partnership_opportunities。

报告

• 向 Campaign、Customer 和 AdGroup 资源添加了 biddable_indirect_install_first_in_app_conversion_micros 指标。

视频

• 扩展了 ShareablePreviewService，通过将 preview_type 设置为 YOUTUBE_LIVE_PREVIEW 来支持 YouTube 直播预览。向 ShareablePreviewError 添加了 UNSUPPORTED_AD_TYPE 和 TOO_MANY_RESOURCES_IN_REQUEST。此功能仅受部分广告类型支持。

v23.1（2026 年 2 月 25 日）

v23.1 中添加了以下新功能和更新。

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

账号管理

• 向 ProductLinkInvitation 和 ProductLink 资源添加了 advertising_partner_properties.allowed_domain。广告合作伙伴将只能在此网域上投放广告。
• 向 Customer 资源添加了 contains_eu_political_advertising 字段。此字段用于检索账号级声明状态，以确定账号是否包含面向欧盟的政治广告，并返回 EuPoliticalAdvertisingStatusEnum。

广告系列

• 新增了对文案准则的支持，该功能可与效果最大化广告系列和搜索广告系列搭配使用，以通过程序化方式控制 AI 生成的文案素材资源。
  • 向 Campaign 资源添加了 Campaign.text_guidelines 字段。
  • 在 text_guidelines 中，您可以定义 term_exclusions 和 messaging_restrictions。
• 添加了 CampaignPrimaryStatusReason.CAMPAIGN_NOT_BOOKED、CampaignPrimaryStatusReason.BOOKING_HOLD_EXPIRING、CampaignPrimaryStatusReason.BOOKING_HOLD_EXPIRED 和 CampaignPrimaryStatusReason.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 以支持跟踪观看广告并随后观看同一频道中视频的用户。

常规

• 已将 CANNOT_TARGET_ONLY_UNDETERMINED 添加到 CriterionErrorEnum。尝试在人口统计信息维度中仅定位到“未确定”类别时，系统会返回此错误。

奖励

• 向 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。
• 向 SearchTermMatchSourceEnum 添加了 VERTICAL_ADS_DATA_FEED，以支持垂直广告数据 Feed，例如旅游广告实体定位。

YouTubeVideoUpload

• 添加了 YouTubeVideoUpload 服务，以支持在 YouTube 上上传和管理视频；添加了 YouTubeVideoUpload 资源，以支持获取上传状态和元数据。此功能仅适用于 REST 和 Python 客户端库。

v23 (2026-01-28)

v23 中添加了以下新功能和更新。

Ads

• 已将 AD_SHARING_NOT_ALLOWED 添加到 AdGroupAdErrorEnum。尝试在多个广告组之间共享广告时，系统会返回此错误，但现在已不允许这样做。
• 向 AdFormatType 添加了新的格式类型：TEXT、VERTICAL_ADS_BOOKING_LINK、VERTICAL_ADS_PROMOTION。
• 在 v23 中移除了对 CallAd 和 CallAdInfo 的支持。如需了解详情，请参阅关于电话广告。

素材资源

• 向 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。

• 添加了对使用 field_type HEADLINE 和 DESCRIPTION 检索 CampaignAsset 的支持。

• 为作为站内链接投放的素材资源向 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 中添加了对 Facebook Messenger 和 Zalo 作为提供方的支持，向 BusinessMessageProviderEnum.BusinessMessageProvider 添加了 FACEBOOK_MESSENGER 和 ZALO，并向 BusinessMessageAsset 添加了新字段 facebook_messenger_info 和 zalo_info。
  • 已将 CUSTOMER_NOT_ON_ALLOWLIST_FOR_MESSAGE_ASSETS 添加到 AssetErrorEnum。

结算

• 现在，通过在 ListInvoicesRequest 中设置 include_granular_level_invoice_details，InvoiceService.ListInvoices 可以在 Invoice 中返回更精细的详细信息，包括广告系列级费用细分、细分的监管费用和调整信息。
• 添加了 RegulatoryFeeTypeEnum 和 UnitOfMeasureEnum。

广告系列

• 添加了 CampaignError.DURATION_TOO_LONG_FOR_TOTAL_BUDGET 和 CampaignError.END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET 错误代码。
• 添加了 Campaign.start_date_time 和 Campaign.end_date_time 以替换 Campaign.start_date 和 Campaign.end_date，从而允许为某些广告系列类型指定时间组成部分。

转化次数

• 向 ConversionActionCategory 添加了 YOUTUBE_FOLLOW_ON_VIEWS，以支持跟踪观看广告并稍后观看同一频道视频的用户。

需求开发

• 添加了 DemandGenVideoResponsiveAdInfo.companion_banner 字段。
• 从 DemandGenMultiAssetAdInfo 中移除了 lead_form_only 字段。

奖励

• 新增了对自选 (CYO) 奖励的支持，使合作伙伴能够以编程方式为其客户获取和应用 Google Ads 奖励：

  • 添加了 IncentiveService：
    • FetchIncentive 方法可用于根据国家/地区、语言以及可选的用户电子邮件地址来获取用户可获得的奖励。这可以返回个性化的“自选”奖励选项。
    • ApplyIncentive 方法可用于将用户选择的奖励应用于特定的 Google Ads 客户账号。
  • 添加了只读资源 AppliedIncentive，可通过 GoogleAdsService.Search 和 GoogleAdsService.SearchStream 进行查询。该资源提供有关已兑换奖励的详细信息，包括奖励的状态、完成进度、奖励金额和相关日期。
  • 在 IncentiveErrorEnum 中添加了新的错误代码，以处理与激励抓取或应用相关的问题。
  • 已将 INVALID_EMAIL_ADDRESS 添加到 AuthenticationErrorEnum。

• 为了更精细地以程序化方式处理失败，我们将在未来的版本中向 IncentivesService 添加更多错误代码。我们建议您关注即将发布的公告和版本说明，了解这些新错误代码，确保您的应用能够应对这些新的故障模式。

规划

• 已将 LIFE_EVENT_USER_INTEREST 添加到 AudienceInsightsDimension。借助这一新维度，用户可以通过以下方法使用“人生大事”来构建受众群体：

  • AudienceInsightsService.GenerateAudienceCompositionInsights
  • AudienceInsightsService.GenerateSuggestedTargetingInsights
  • AudienceInsightsService.GenerateInsightsFinderReport
  • ContentCreatorInsightsService.GenerateCreatorInsights

  其他 AudienceInsightsService 方法（例如 AudienceInsightsService.GenerateAudienceOverlap 和 AudienceInsightsService.GenerateTargetingSuggestionMetrics）不支持人生大事。

• ReachPlanService.GenerateConversionRates 响应现在包含平台，可根据平台控件（例如 Gmail、Shorts）提供不同的转化率建议。此功能仅适用于需求开发广告系列。

• 向 YouTubeChannelInsights 添加了 LanguageDistribution，用于提供 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 以查询商店位置详细信息。
  • 为 AI Max 广告系列添加了 MatchedLocationInterestView，可提供按用户表现出兴趣的地理位置细分的效果指标。

• 效果最大化广告系列：

  • 效果最大化广告系列的已启用广告资源网类型细分。

• 下架：

  • 移除了汇总素材资源效果标签指标。不再针对搜索广告和展示广告返回效果标签枚举。

购物

• ShoppingPerformanceView 现在支持按转化日期细分的以下指标：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。
• 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。
• 已将 product_image_uri 添加到 ShoppingProduct。

竖屏广告

• 为使用旅游 Feed 的搜索广告系列向 AdGroup 添加了 vertical_ads_format_setting，以便控制可以投放哪些广告格式。
• 向 AdGroupCriterion 添加了 vertical_ads_item_group_rule_list 条件类型。已将 vertical_ads_item_group_rule 添加到 SharedCriterion。这些条件允许在包含旅游 Feed 的搜索广告系列中定位商品组。
• 现在，您可以将垂直广告数据 Feed 与正在投放 AI Max 的搜索广告系列相关联，以便在文字广告旁边展示房源宣传广告和预订链接旅游广告。在广告组一级，您可以使用 vertical_ads_format_setting 控制要展示的广告格式，并定义一组商品组规则，以定位垂直广告数据 Feed 中的部分实体。此外，现在还可以按 AdFormatType 和垂直广告数据 Feed 中的维度细分报告。

视频

• 添加了 AdVideoAssetInfo.ad_video_asset_feature_control 字段。
• 添加了 CampaignCriterionError.INVALID_VIDEO_LINEUP_ID 错误代码。
• 为 YouTube 上的音频广告添加了可听性指标，用于报告广告是否可听以及有多少展示次数的可听性可以衡量。

v22.1（2026 年 2 月 25 日）

v22.1 中添加了以下新功能。

账号管理

• 向 Customer 资源添加了 contains_eu_political_advertising 字段。此字段用于检索账号级声明状态，以确定账号是否包含面向欧盟的政治广告，并返回 EuPoliticalAdvertisingStatusEnum。

广告系列

• 添加了 Campaign.missing_eu_political_advertising_declaration，以支持查询和过滤缺少以下声明的广告系列：是否包含面向欧盟的政治广告。

v22（2025 年 10 月 15 日）

v22 中添加了以下新功能和更新。

素材资源

• 添加了 LANDING_PAGE_PREVIEW 作为新的图片素材资源字段类型。
• 推出了 AssetGenerationService（Beta 版）：
  • 此服务允许使用生成式 AI 生成文本和图片素材资源。此服务最初仅面向有限数量的封闭式 Beta 版参与者提供。
  • GenerateText：根据最终到达网址、自由格式提示、关键字和现有广告系列背景信息等输入内容生成文字。
  • GenerateImages：根据最终到达网址、自由格式提示、现有广告系列背景信息等输入内容生成图片，或通过重新确定现有商品图片的背景信息来生成图片。
  • 素材资源生成期间的错误会返回代码 AssetGenerationErrorEnum。

广告系列

• 为应用安装广告系列 (ACi) 添加了新的出价目标，可在不指定目标的情况下进行优化，有助于快速扩大规模或在难以确定合适的目标时使用。在 AppCampaignBiddingStrategyGoalType 中： * OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA：与标准尽可能提高转化次数出价策略搭配使用。
  • OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS：与标准尽可能提高转化价值出价策略搭配使用。
• 新增了对固定广告占有率出价策略类型的支持。
• 添加了 Campaign.feed_types，用于显示附加到广告系列的信息流类型。对于效果最大化广告系列，此参数可以指明业务垂直行业，例如零售行业的 MERCHANT_CENTER_FEED。
• 允许将 NEGATIVE_KEYWORDS 共享集附加到 MULTI_CHANNEL（对于应用广告系列）和 LOCAL 广告系列。

需求开发

• 为需求开发广告系列添加了“目标每次点击费用”出价策略。此策略会设置出价，以在配置的目标每次点击费用 (CPC) 下尽可能争取更多点击次数。
  • 使用 Campaign.target_cpc 设置广告系列级目标每次点击费用。
  • 使用 AdGroup.target_cpc_micros 在广告组级别进行替换。
• 添加了新的 AssetAutomationType： * GENERATE_DESIGN_VERSIONS_FOR_IMAGES：适用于 DemandGenMultiAssetAds。如果启用此功能，系统会添加设计元素并将文字素材资源嵌入到图片素材资源中，以创建具有不同宽高比的新图片素材资源。默认情况下，系统会为新 DemandGenMultiAssetAds 启用此功能。
• 添加了新的 AssetAutomationType： * GENERATE_VIDEOS_FROM_OTHER_ASSETS：适用于 DemandGenMultiAssetAds。如果启用，系统会使用图片和文字等其他素材资源生成视频。然后，这些视频可用于创建新的 DemandGenVideoResponsiveAds。默认情况下，系统会为新 DemandGenMultiAssetAds 启用此功能。
• 将字段 BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros 重命名为 minimum_budget_amount_micros。

常规

• 添加了每 AddBatchJobOperations 请求 10,000 次操作的限制。
• 更新了 ListBatchJobResultsRequest 中 page_size 字段的处理方式：
  • 如果未设置 page_size 或将其设置为 0，则现在默认设置为最大值 1,000（之前返回 INVALID_PAGE_SIZE）。
  • 如果 page_size 超过 1,000，API 现在会返回 INVALID_PAGE_SIZE 错误（之前会默默地将上限设为 1,000）。
• 添加了一个新的错误代码：QuotaError.PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED，用于指示何时超出付款资料激活率限制。

效果最大化广告系列

• 为效果最大化广告系列添加了新的 AssetAutomationType 值：
  • GENERATE_IMAGE_ENHANCEMENT：启用自动创建增强型图片的功能，例如自动剪裁。默认处于启用状态。
  • GENERATE_IMAGE_EXTRACTION：启用自动从最终到达网址中获取图片的功能。默认采用账号级动态图片附加信息设置。
• 移除了效果最大化广告系列的 AssetPerformanceLabel。
• 已移除的 Campaign.url_expansion_opt_out 的功能现在通过在 AssetAutomationSetting 中设置 AssetAutomationType FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION 来管理。
• 为效果最大化广告系列添加了新的细分。这些细分仅适用于效果最大化广告系列，如果选择任何其他广告系列类型，系统都不会返回数据。
  • ad_using_product_data：表示广告是否使用 Google Merchant Center Feed 中的商品数据。
  • ad_using_video：表示广告是否使用视频素材资源。

规划

• 在 UserListCrmDataSourceType 中，添加了值 THIRD_PARTY_PARTNER_DATA。
  • 添加了与合作伙伴受众群体相关的新错误代码：
  • PARTNER_AUDIENCE_SOURCE_NOT_SUPPORTED_FOR_USER_LIST_TYPE
  • PARTNER_AUDIENCE_TYPE_NOT_SUPPORTED_FOR_USER_LIST_TYPE
  • COMMERCE_PARTNER_NOT_ALLOWED
  • PARTNER_AUDIENCE_INFO_NOT_SUPPORTED_FOR_USER_LIST_TYPE
  • PARTNER_MANAGER_ACCOUNT_DISALLOWED
  • PARTNER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA
  • ADVERTISER_TOS_NOT_ACCEPTED
  • ADVERTISER_PARTNER_LINK_MISSING
  • ADVERTISER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA
  • ACCOUNT_SETTING_TYPE_NOT_ALLOWED_FOR_USER_LIST_TYPE
  • INVALID_CAMPAIGN_TYPE_FOR_THIRD_PARTY_PARTNER_DATA_LIST
• 已将 is_active_live_stream_creator 添加到 YouTubeMetrics。 此值由 ContentCreatorInsightsService.GenerateCreatorInsights 返回，用于指示创作者是否在过去 90 天内发布过直播。

• 在 PlannableUserList 中添加了包含 UserListCrmDataSourceType 的新 PlannableUserListMetadata 消息。'ReachPlanService.ListPlannableUserLists' 会返回此消息，以显示 CRM 用户名单数据源是 FIRST_PARTY 还是 THIRD_PARTY_PARTNER_DATA。

• 在 ReachPlanService 中，添加了字段 trueview_views，该字段取代了 views 字段。

• 在 TrendInsight 中，添加了对 related_videos 和 related_creators 的支持。还在 YouTubeVideoAttributeMetadata.video_properties 和 YouTubeVideoAttributeMetadata.publish_date 中添加了视频属性元数据和发布日期。

  • AudienceInsightsService.GenerateInsightsFinderReport 现在支持 parental_status 和 income_ranges，以及更复杂的“与”/“或”主题和受众群体组合。

报告

• 添加了两种新的点击类型：CLICK_TO_MESSAGE_THIRD_PARTY_CLICK 和 CLICK_TO_MESSAGE_LANDING_PAGE_CLICK。
• AssetGroupAsset 现在可按 device、conversion_action、conversion_action_name 和 conversion_action_category 进行细分。
• AdGroupAdAssetView 现已全面支持 RESPONSIVE_SEARCH_AD 的效果和转化指标。之前，此视图中仅针对此广告类型返回展示次数。
• 为了方便您探索智能出价，以下指标现在可按日期字段（date、month、quarter、week、year）进行细分：
  • clicks_unique_query_clusters
  • conversions_unique_query_clusters
  • impressions_unique_query_clusters
• 添加了新资源：TargetingExpansionView，用于报告手动定位的扩展指标，例如 AI Max 搜索广告系列的无关键字扩展。

• 为效果最大化广告系列添加了新的细分。请参阅效果最大化广告系列更新。

  ### 购物

• 修复了 ShoppingProduct 资源中指标的广告系列和广告组范围。

统一目标

• 添加了对客户留存目标的支持，以便针对重新吸引现有客户进行优化。
  • 使用 CampaignRetentionGoalSettings.target_option 配置定位： * TARGET_SPECIFIC：仅使用与广告系列关联的用户列表中的用户。（目前仅限许可名单）。
    • TARGET_ALL（默认）：定位所有用户以进行再互动。

视频

• 重命名了多个与视频观看次数相关的指标：
  • average_cpv现已更名为 trueview_average_cpv
  • video_view_rate现已更名为 video_trueview_view_rate
  • video_views现已更名为 video_trueview_views
  • video_view_rate_in_feed现已更名为 video_trueview_view_rate_in_feed
  • video_view_rate_in_stream现已更名为 video_trueview_view_rate_in_stream
  • video_view_rate_shorts现已更名为 video_trueview_view_rate_shorts
• 添加了视频广告观看时长的相关指标：
  • video_watch_time_duration_millis：总观看时长。
  • average_video_watch_time_duration_millis：每次展示的平均观看时长。

v21.1（2026 年 2 月 25 日）

v21.1 中添加了以下新功能。

账号管理

• 向 Customer 资源添加了 contains_eu_political_advertising 字段。此字段用于检索账号级声明状态，以确定账号是否包含面向欧盟的政治广告，并返回 EuPoliticalAdvertisingStatusEnum。

广告系列

• 添加了 Campaign.missing_eu_political_advertising_declaration，以支持查询和过滤缺少以下声明的广告系列：是否包含面向欧盟的政治广告。

v21（2025 年 8 月 6 日）

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

AI Max 搜索广告系列

• 您现在可以使用 Campaign 的 ai_max_setting.enable_ai_max 字段来启用 AI Max 搜索广告系列。AI Max 搜索广告系列可通过搜索字词匹配扩大搜索广告系列的覆盖面，并允许控制在设置时是否使用定位和广告素材控制功能。在之前的版本请求中设置的文案素材资源自动化和品牌列表控制功能仍会生效，直到明确切换并停用 AI Max 搜索广告系列为止。Campaign.ai_max_setting.bundling_required 可用于确定是否必须启用 AI Max 搜索广告系列才能使用或修改文案素材资源自动化和品牌列表控制功能。如果父广告系列已启用 AI Max 搜索广告系列，则可以使用 AdGroup.ai_max_ad_group_setting.disable_search_term_matching 停用搜索字词匹配。请参阅我们的博文利用 AI Max 搜索广告系列将效果提升到新高度。

• 添加了 CampaignError.AI_MAX_MUST_BE_ENABLED，当您选择启用 FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION 但未在广告系列中启用 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、promotion_barcode_info 和 promotion_qr_code_info。条形码和二维码字段位于 promotion_trigger oneof 中。请参阅帮助中心文章宣传广告素材简介。

• 已将 FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION 添加到 AssetAutomationTypeEnum。借助此设置，您可以控制搜索广告系列中根据最终到达网址自动生成的文字素材资源和着陆页。

• 添加了一项新服务 AutomaticallyCreatedAssetRemovalService.RemoveCampaignAutomaticallyCreatedAsset，用于从 Campaign 中移除自动制作的素材资源。此服务仅支持移除最终到达网址扩展素材资源。

• 向 ServedAssetFieldType 枚举添加了 DESCRIPTION_PREFIX。这修正了 ad_group_ad_asset_combination_view 中的 served_asset_field_type 对于用作说明前缀的资源为 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 字段。以前，此字段只能在创建新广告系列时设置。设置后，该字段仍不可变。

• 通过使用在经理账号一级定义的 NEGATIVE_PLACEMENTS 类型的共享列表，广告客户现在可以使用 CustomerNegativeCriterion 条件在各个广告客户客户账号中排除一系列展示位置。

• 向 ServedAssetFieldType 枚举添加了 DESCRIPTION_PREFIX。这修正了 ad_group_ad_asset_combination_view 中的 served_asset_field_type 对于用作说明前缀的资源为 UNKNOWN 的问题。

• 在 MaximizeConversionValue 和 TargetRoas 出价策略中添加了对字段 target_roas_tolerance_percent_millis 的支持。TargetRoas.target_roas_tolerance_percent_millis 仅适用于组合出价策略，而组合出价策略仅适用于搜索广告系列。

• 更改了 ProductGroup 错误代码。对于启用部分失败的请求，系统将返回 LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION 而不是 INVALID_LISTING_GROUP_HIERARCHY。

• 添加了新资源 LocationInterestView，用于汇总广告组地理位置兴趣条件的效果。

转化次数

• 为 conversion_attribution_event_type 段添加了 ENGAGED_VIEW 作为新值。

• 客户将无法再在 ConversionUploadService 中使用 debug_enabled 模式。如果此字段设置为 TRUE，则之前用于区分增强型潜在客户转化数据导入的 CLICK_NOT_FOUND 错误与 SUCCESS 错误。

需求开发

• 添加了错误代码 CampaignBudgetError.BUDGET_BELOW_DAILY_MINIMUM。未来，如果尝试为需求开发广告系列设置非常低的预算金额，系统将返回此错误。有关所需最低预算的详细信息可在新的错误详情字段 budgetDailyMinimumErrorDetails 中找到。

欧盟政治广告变更

v19.2 和 v20.1 版本中也做出了这些欧盟政治广告变更。

• 添加了 Campaign.contains_eu_political_advertising。此字段用于指明您的广告系列是否包含面向欧盟的政治广告内容。如果此字段设置为 CONTAINS_EU_POLITICAL_ADVERTISING，则自 2025 年 9 月 22 日起，相应广告系列将无法在欧盟境内投放。如果未设置此字段，则用于创建新广告系列的 API 调用将失败，并显示 FieldError.REQUIRED 错误。

  对于任何现有广告系列，您都应先设置 contains_eu_political_advertising 字段，然后再尝试在广告系列级或广告组级更改邻近区域、地理位置或地理位置组定位。如果广告系列尚未完成自我声明，则用于为现有广告系列创建或更新这些广告系列或广告组定位条件的 API 调用将失败，并显示 CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION 错误。

  对于版本 v19.x 和 20.x，目前尚未强制要求设置此字段，但未来会强制要求。此项变更将提前公布。

• 如果实验的广告系列未自行声明是否包含定位到欧盟的政治广告，则试用和实验会抛出 ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION。

效果最大化广告系列

• 对于新的效果最大化广告系列，Campaign.brand_guidelines_enabled 的默认值现在为 true。

• 添加了 campaign_search_term_view 报告。此视图提供在广告系列级汇总的搜索字词指标。此视图还引入了对搜索字词的效果最大化广告系列支持。

• 为 search_term_match_type 段添加了 PERFORMANCE_MAX 作为新值。

规划

• 添加了新方法 ReachPlanService.ListPlannableUserInterests，可让广告客户发现 ReachPlanService.GenerateReachForecast 支持的用户兴趣（亲和度和目标客户群）。该方法支持搜索特定用户兴趣类型，以及查询名称和路径。

• 向 ReachPlanService.ListPlannableUserLists 添加了 AdditionalApplicationInfo 作为可选输入字段。

• 添加了对 AudienceInsightsService.ListAudienceInsightsAttributes 的支持，以获取发出请求的客户 ID 的可用第一方用户名单。

• 向 AudienceInsightsService.GenerateAudienceCompositionInsights 添加了第一方用户名单支持，以获取针对用户名单的受众群体的分析洞见。以用户列表为目标的任何请求都只会返回受众群体指数，并且仅适用于以下 AudienceInsightsDimension：AGE_RANGE、GENDER、AFFINITY_USER_INTEREST、IN_MARKET_USER_INTEREST。

• 将 AudienceInsightsService.GenerateTargetingSuggestionMetrics 的受众群体输入类型更新为 InsightsAudience。新的受众群体输入类型支持用户兴趣的 AND-of-ORs 组合，可为更自定义的受众群体定义提供潜在覆盖面指标。

• 向 TrendInsightMetrics 添加了受众群体份额，以获取趋势的受众群体份额。

• 向 KnowledgeGraphAttributeMetadata 添加了新的相关类别，以便用户按类别过滤知识图谱属性。

报告

• 现在，AssetGroupAsset、ChannelAggregateAssetView 和 CampaignAggregateAssetView 中提供各种新指标。此外，对于 ChannelAggregateAssetView 和 CampaignAggregateAssetView，之前在效果最大化广告系列中归零的 impressions 现在将报告其真实值。

• 使 AssetSet 资源可通过 ChangeStatus 选择，以便用户可以通过一次查询获取有关 AssetSet 或 CampaignAssetSet 类型资源的更多信息。

• 使 CampaignAssetSet 资源可通过 ChangeStatus 进行选择，以便用户通过一次查询获取有关 AssetSet 或 CampaignAssetSet 类型资源的更多信息。

• 添加了一个新的细分search_term_targeting_status，可在广告系列搜索字词视图中选择。

• 添加了新的 final_url_expansion_asset_view。

• 在 AssetGroup 报告中添加了对指标 value_adjustment 和 all_value_adjustment 的支持。

• 使 AssetGroupAsset 可按 ad_network_type 进行细分。

• 添加了一个新的细分 landing_page_source，可与 landing_page_view 资源搭配使用。

• 添加了一个新的细分 search_term_match_source，可在搜索字词视图和广告系列搜索字词视图中选择。

• 添加了一个新的细分match_type，可从关键字视图中选择。

• 新增了对以下指标的支持，用于衡量唯一搜索查询意图聚类：

  • clicks_unique_query_clusters
  • conversions_unique_query_clusters
  • impressions_unique_query_clusters

• 在 click_view 细分中添加了新的点击类型 VEHICLE_ASSETS，用于跟踪和报告与车辆资源特有的广告格式相关的点击。

搜索广告系列中“目标广告支出回报率”出价策略的智能出价探索

• 现在，您可以通过将 MaximizeConversionValue 和 TargetRoas 出价策略中的字段 target_roas_tolerance_percent_millis 设置为介于 10000（10%）到 30000（30%）之间的任何可被 1000 整除的值，为搜索广告系列启用智能出价探索。MaximizeConversionValue 出价策略还需要设置 target_roas 字段。 TargetRoas.target_roas_tolerance_percent_millis 仅适用于组合策略。请参阅我们关于智能出价探索的博文和帮助中心文章。

• 现在，系统支持针对具有唯一查询意图的聚类，汇总以下指标的多样性报告。Google Ads 界面中提供按时间段细分的数据视图。

  • clicks_unique_query_clusters
  • conversions_unique_query_clusters
  • impressions_unique_query_clusters

视频

• 添加了 YouTubeVideoListAsset。还添加了 Asset#youtube_video_list_asset，可用于在 campaign 和 YouTubeVideoListAsset 类型之间创建链接。请参阅帮助中心文章使用相关视频。

• 向 YouTubeChannelInsights 和 YouTubeVideoAttributeMetadata 添加了新的元数据字段。

• 公开了新的点击类型：VIDEO_RELATED_VIDEOS_CLICK、VIDEO_CHANNEL_CLICK 和 PRODUCT_ASSETS。

• 向 VideoAdInventoryControl 添加了 allow_non_skippable_in_stream 字段，以允许自适应视频广告作为不可跳过的插播广告投放。此选项适用于支持将不可跳过的广告格式与其他广告格式混用的广告系列。

• 添加了 Campaign.VideoCampaignSettings.video_ad_sequence 和 AdGroup.VideoAdGroupSettings.VideoAdSequenceStepSetting 字段（只读）。请参阅帮助中心文章关于视频广告序列。

• 向 YouTubeChannelInsights 和 YouTubeVideoAttributeMetadata 添加了新的元数据字段。

• 向 CampaignCriterion 和 AdGroupCriterion 添加了 VIDEO_LINEUP 条件类型和 video_lineup 字段。此功能仅面向已列入许可名单的账号提供。如需了解详情，请与您的 Google 业务开发代表联系。

• 添加了详细和分组级的内容适宜性报告。请参阅帮助中心文章“内容适宜性”报告简介。

归档版本说明

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