功能弃用和无版本控制的变更

本页面会跟踪 Google Ads API 中的功能弃用和无版本变更。如需了解版本化更改,请参阅版本说明

请定期关注 Google Ads 开发者博客,以便率先了解即将弃用的功能。

下表列出了最近的 API 版本中发生的具体功能弃用、验证更改和其他未版本化的更新。

生效日期 更改区域 更改类型 指南和说明
2026-09-092026 年 9 月 9 日 API 政策 弃用 开发者令牌已被弃用并已停用。如需详细了解如何管理 API 访问权限,请参阅更新后的 API 访问权限管理和开发者令牌弃用指南。
2025-07-012025 年 7 月 品牌推广指南 行为转变 对于启用了品牌规范的效果最大化广告系列(这是新广告系列的默认设置),商家名称商家徽标素材资源必须在广告系列一级使用 CampaignAsset(字段类型分别为 BUSINESS_NAMELOGO)进行管理,而不是在素材资源组一级使用 AssetGroupAsset 进行管理。如需了解详情,请参阅有关商家名称和徽标素材资源的博文
2026-01-012026 年 1 月 来电专用广告 弃用 我们不再支持制作新的来电专用广告 (CallAdInfo)。现有的来电专用广告将于 2027 年 2 月停止投放,并且 API 支持将完全移除。请改用包含电话素材资源的自适应搜索广告。如需了解详情,请参阅有关升级来电专用广告的博文
2026-02-022026 年 2 月 2 日 IP 地址和会话属性 访问权限限制 新用户在转化数据导入过程中不得使用会话属性或 IP 地址数据。如果未使用 ClickConversion.session_attributes_encodedClickConversion.session_attributes_key_value_pairs 发送会话数据,或者未使用 ClickConversion.user_identifiers 发送 IP 地址,且未先添加到许可名单,则会失败并显示 CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE 错误。请改用 Data Manager API。如需了解详情,请参阅有关 IP 地址和会话属性的博文
2026-04-012026 年 4 月 1 日 目标客户匹配 访问权限限制 如果开发者令牌在 2025 年 10 月 1 日至 2026 年 3 月 31 日期间未发出任何目标客户匹配请求,则该令牌将无法再使用 Google Ads API 来执行目标客户匹配工作流程。如果向 OfflineUserDataJobServiceUserDataService 发出针对这些令牌的请求,则会失败并显示 CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE 错误。请改用 Data Manager API 来处理目标客户匹配工作流程。如需了解详情,请参阅有关目标客户匹配支持的博文

注意:开发者令牌已弃用,取而代之的是 Google Cloud 项目,但此历史访问权限限制仍然有效。
2026-04-012026 年 4 月 1 日 需求开发广告系列的预算 验证规则 所有需求开发广告系列都必须设置至少 5 美元(或本地货币的等值金额)的每日预算。如果 API 创建或更新操作导致每日预算低于此阈值,则会失败。这会抛出 BUDGET_BELOW_DAILY_MINIMUM 错误(详情可在 details.budget_per_day_minimum_error_details 字段中找到)。如果现有广告系列的预算低于最低预算,则在修改其预算或天数之前,不会受到影响。如需了解详情,请参阅有关最低预算要求的博文
2026-06-012026 年 6 月 1 日 数据保留 政策变更 细粒度报告数据(每天、每小时、每周)的保留期限将缩短至 37 个月。高级别数据(按月、按季度、按年)将继续保留 11 年。如需了解详情,请参阅有关数据保留政策的博文
2026-06-152026 年 6 月 15 日 线下转化次数 访问权限限制 如果开发者令牌在 2025 年 12 月 17 日至 2026 年 6 月 15 日期间未发送过任何线下转化数据上传请求,则无法再使用 Google Ads API 上传线下转化数据。针对这些令牌的 UploadClickConversions 请求将返回 CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE 错误。请改用 Data Manager API 迁移线下转化工作流。如需了解详情,请参阅有关线下点击转化变更的博文

注意:开发者令牌已弃用,取而代之的是 Google Cloud 项目,但此历史访问权限限制仍然有效。
2026-09-232026 年 9 月 23 日 智能广告系列 弃用 无法制作新的智能广告系列。现有的智能广告系列将继续投放广告,并且可以更新。如需了解详情,请参阅有关智能广告系列支持的博文
2026-09-302026 年 9 月 语言定位 弃用 对于搜索广告系列、AI Max 搜索广告系列以及在 Google 搜索上展示的效果最大化广告系列,我们不再支持手动设置语言定位 (CampaignCriterion.language)。而是会根据广告素材和着陆页所用的语言自动与用户匹配。在搜索广告系列中添加或更新 CampaignCriterion.language 失败,并显示 ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT 错误(效果最大化广告系列请求不会返回错误,因为该设置仍适用于其他渠道)。在创建或更新搜索广告系列时,请停止设置语言条件。如需了解详情,请参阅有关语言定位变更的博文