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

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

定期关注 Google Ads 开发者博客,第一时间了解即将弃用的功能。

下表列出了 Google Ads API 中弃用的具体功能、验证更改和其他无版本更新。

生效日期 更改区域 更改类型 指南和说明
2025-07-012025 年 7 月 品牌推广指南 行为转变 对于启用了品牌规范的效果最大化广告系列(新广告系列的默认设置),必须使用 CampaignAsset(字段类型分别为 BUSINESS_NAME 和 LOGO)在广告系列一级管理商家名称和商家徽标素材资源,而不是使用 AssetGroupAsset 在素材资源组一级进行管理。如需了解详情,请参阅关于商家名称和徽标素材资源的博文。
2026-01-012026 年 1 月 来电专用广告 弃用 不再支持制作新的来电专用广告 (CallAdInfo)。现有的来电专用广告将于 2027 年 2 月停止投放,并且 API 支持也将完全移除。请改用包含电话素材资源的自适应搜索广告。如需了解详情,请参阅关于升级来电专用广告的博文。
2026-02-02: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-04-012026 年 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-04-012026 年 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-06-01:2026 年 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-092026 年 9 月 9 日 API 政策 弃用 开发者令牌已被弃用并停用。如需详细了解如何管理 API 访问权限,请参阅更新后的API 访问管理和弃用开发者令牌指南。
2026-09-23:2026 年 9 月 23 日 智能广告系列 弃用 无法制作新的智能广告系列。现有的智能广告系列会继续投放广告,并且可以更新。如需了解详情,请参阅关于智能广告系列支持的博文。
2026-09-302026 年 9 月 语言定位 弃用 对于搜索广告系列、AI Max 搜索广告系列以及在 Google 搜索上展示的效果最大化广告系列,不再支持手动语言定位 (CampaignCriterion.language)。而是会根据广告素材和着陆页的语言以及用户的语言偏好设置,自动向用户展示匹配的广告。 在搜索广告系列中添加或更新 CampaignCriterion.language 会失败,并显示 ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT 错误,但现有语言条件仍会在查询中返回,并且可以使用 CampaignCriterionService 移除(效果最大化广告系列请求不会返回错误,因为该设置仍适用于其他渠道)。在创建或更新搜索广告系列时,请停止设置语言条件。如需了解详情,请参阅语言定位条件和有关语言定位变更的博文。