本页面会跟踪 Google Ads API 中弃用的功能和未版本化的更改。如需了解版本化变更,请参阅版本说明。
定期关注 Google Ads 开发者博客,第一时间了解即将弃用的功能。
下表列出了 Google Ads API 中弃用的具体功能、验证更改和其他无版本更新。
| 生效日期 | 更改区域 | 更改类型 | 指南和说明 |
|---|---|---|---|
| 2025 年 7 月 | 品牌推广指南 | 行为转变 |
对于启用了品牌规范的效果最大化广告系列(新广告系列的默认设置),必须使用 CampaignAsset(字段类型分别为 BUSINESS_NAME 和 LOGO)在广告系列一级管理商家名称和商家徽标素材资源,而不是使用 AssetGroupAsset 在素材资源组一级进行管理。如需了解详情,请参阅关于商家名称和徽标素材资源的博文。
|
| 2026 年 1 月 | 来电专用广告 | 弃用 |
不再支持制作新的来电专用广告 (CallAdInfo)。现有的来电专用广告将于 2027 年 2 月停止投放,并且 API 支持也将完全移除。请改用包含电话素材资源的自适应搜索广告。如需了解详情,请参阅关于升级来电专用广告的博文。
|
| :2026 年 2 月 2 日 | IP 地址和会话属性 | 访问权限限制 |
在转化导入过程中,新用户将无法使用会话属性或 IP 地址数据字段。如果未先添加到许可清单,则使用 ClickConversion.session_attributes_encoded 或 ClickConversion.session_attributes_key_value_pairs 发送会话数据,或使用 ClickConversion.user_identifiers 发送 IP 地址,都会失败并显示 CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE 错误。请改用 Data Manager API。如需了解详情,请参阅有关 IP 地址和会话属性的博文。
|
| 2026 年 4 月 1 日 | 目标客户匹配 | 访问权限限制 |
如果开发者令牌在 2025 年 10 月 1 日至 2026 年 3 月 31 日期间未发出任何目标客户匹配请求,则无法使用 Google Ads API 执行目标客户匹配工作流程。针对这些令牌向 OfflineUserDataJobService 或 UserDataService 发出的请求会失败,并显示 CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE 错误。请改用 Data Manager API 来执行目标客户匹配工作流程。如需了解详情,请参阅关于目标客户匹配支持的博文。注意:开发者令牌此后已被弃用,取而代之的是 Google Cloud 项目,但这一历史访问限制仍然有效。 |
| 2026 年 4 月 1 日 | 需求开发广告系列预算 | 验证规则 |
所有需求开发广告系列都必须设置不低于 5 美元(或本地货币的等值金额)的每日预算。在 v26 及更高版本中,您可以查询 CurrencyConstant.demand_gen_info.minimum_budget_per_day_micros,以检索某种币种所需的最低每日预算(请参阅制作需求开发广告系列)。如果 API 创建或更新操作导致每日预算低于此阈值,则操作会失败并显示 CampaignBudgetError.BUDGET_BELOW_PER_DAY_MINIMUM 错误,并在 details.budget_per_day_minimum_error_details 中返回所需的最低金额。
现有广告系列即使预算低于最低要求,也不会受到影响,除非您修改其预算或投放时长(以天为单位)。如需了解详情,请参阅有关最低预算要求的博文。
|
| :2026 年 6 月 1 日 | 数据保留 | 政策变更 | 细粒度报告数据(每天、每小时、每周)的保留期限缩短至 37 个月。高级别数据(每月、每季度、每年)仍会保留 11 年。如需了解详情,请参阅有关数据保留政策的博文。 |
| 2026 年 6 月 15 日 | 线下转化次数 | 访问权限限制 |
如果开发者令牌在 2025 年 12 月 17 日至 2026 年 6 月 15 日期间未发出过线下转化数据上传请求,则无法使用 Google Ads API 上传线下转化数据。
针对这些令牌的 UploadClickConversions 请求会返回 CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE 错误。请改为将线下转化工作流迁移到 Data Manager API。如需了解详情,请参阅有关线下点击转化更改的博文。注意:自此之后,开发者令牌已弃用,取而代之的是 Google Cloud 项目,但此历史访问限制仍然有效。 |
| 2026 年 9 月 9 日 | API 政策 | 弃用 | 开发者令牌已被弃用并停用。如需详细了解如何管理 API 访问权限,请参阅更新后的API 访问管理和弃用开发者令牌指南。 |
| :2026 年 9 月 23 日 | 智能广告系列 | 弃用 | 无法制作新的智能广告系列。现有的智能广告系列会继续投放广告,并且可以更新。如需了解详情,请参阅关于智能广告系列支持的博文。 |
| 2026 年 9 月 | 语言定位 | 弃用 |
对于搜索广告系列、AI Max 搜索广告系列以及在 Google 搜索上展示的效果最大化广告系列,不再支持手动语言定位 (CampaignCriterion.language)。而是会根据广告素材和着陆页的语言以及用户的语言偏好设置,自动向用户展示匹配的广告。
在搜索广告系列中添加或更新 CampaignCriterion.language 会失败,并显示 ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT 错误,但现有语言条件仍会在查询中返回,并且可以使用 CampaignCriterionService 移除(效果最大化广告系列请求不会返回错误,因为该设置仍适用于其他渠道)。在创建或更新搜索广告系列时,请停止设置语言条件。如需了解详情,请参阅语言定位条件和有关语言定位变更的博文。
|