
Google Ads API v19 正式发布,本次更新重点增强了 Performance Max 活动的视频素材能力与品牌指南功能,同时涉及大量新增、变更及废弃项。以下是核心更新摘要:
账户管理与广告素材更新
- 账户管理:CampaignError 新增 CREATION_DENIED_FOR_POLICY_VIOLATION 和 CREATION_DENIED_INELIGIBLE_MCC 值,以应对即将实施的策略变更。
- Demand Gen 广告:新增 DemandGenMultiAssetAdInfo.tall_portrait_marketing_images 字段,支持宽高比为 9:16 的竖屏图像素材。
- 消息素材(白名单):通过 Asset.business_message_asset 等字段支持 WhatsApp 消息素材,新增相关枚举及资源限制类型。
- 自动化素材:新增 GENERATE_LANDING_PAGE_PREVIEW 类型支持自动生成落地页预览;GENERATE_SHORTER_YOUTUBE_VIDEOS 现已默认启用,适用于需求生成视频响应式广告。
- 应用深层链接(白名单):新增 Asset.app_deep_link_asset 支持。
转化追踪与数据源迁移
转化目标优化
- LifecycleGoalValueSettings.high_lifetime_value 结束测试阶段,现可修改。
- 新增 CustomerLifecycleGoal.owner_customer 字段,用于标识拥有该生命周期目标的客户资源名称。
- 正式弃用 ConversionActionType.SALESFORCE。
数据源实体移除
全面移除 Feed、FeedMapping、FeedService 等所有数据源相关实体。用户需迁移至资产(Assets)实现相同功能,具体请参考官方迁移说明。
Performance Max 与视频功能增强
全效通(PMax)升级
- 品牌指南(白名单):创建 PMax 广告系列时可配置 Campaign.brand_guidelines_enabled,支持设置品牌颜色与字体族。现有活动可通过 CampaignService.EnablePMaxBrandGuidelines 启用,但不支持禁用。注意:此功能与旅游目标 PMax 不兼容。
- 增强视频素材:支持为 PMax 活动自动生成增强型 YouTube 视频(GENERATE_ENHANCED_YOUTUBE_VIDEOS)。
- 错误处理:新增 BatchJobError.CAMPAIGN_AND_CAMPAIGN_ASSET_TRANSACTION_FAILURE 及 BrandGuidelinesMigrationError。
视频数据链接管理
配合 DataLinkService.CreateDataLink,新增 RemoveDataLink(移除链接)和 UpdateDataLink(接受/拒绝/撤销链接)方法。同时,AdType、AdvertisingChannelSubType 和 AdGroupType 枚举中已移除对 VIDEO_OUTSTREAM 的支持。
行业特定功能与规划工具
酒店与旅游
ValueRuleItineraryAdvanceBookingWindow 的 min_days 和 max_days 改为可选字段,允许设置为 0,支持针对当天旅行搜索进行定向投放。
内容创作者洞察(白名单)
- 新增 ContentCreatorInsightsService.GenerateTrendingInsights,可查看特定受众在 YouTube 上的热门内容主题。
- GenerateCreatorInsightsRequest 新增 country_locations 和 search_brand 字段,支持按国家/地区及品牌筛选创作者。
- YouTubeChannelInsights 新增 channel_url、channel_description 和 top_videos 字段。
- AudienceInsightsAttributeMetadata 新增 youtube_video_metadata 等元数据字段。

