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

本页面跟踪 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-022026 年 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-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-092026 年 9 月 9 日 API 政策 弃用 开发者令牌已弃用并已停用。如需详细了解如何管理 API 访问权限,请参阅更新后的 API 访问管理 和开发者令牌停用指南。
2026-09-232026 年 9 月 23 日 智能广告系列 弃用 无法制作新的智能广告系列。现有智能广告系列 会继续投放广告,并且可以更新。如需了解详情,请参阅有关智能广告系列支持的博文。
2026-09-302026 年 9 月 语言定位 弃用 对于搜索广告系列、AI Max 搜索广告系列以及在 Google 搜索上展示的效果最大化广告系列,系统不再支持手动语言定位 (CampaignCriterion.language)。广告会根据广告素材和着陆页的语言自动与用户匹配。如果对搜索广告系列添加或更新 CampaignCriterion.language,则会失败并显示 ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT 错误(效果最大化广告系列请求不会返回错误,因为该 设置仍适用于其他渠道)。请不要在制作或更新搜索广告系列时设置语言 条件。如需了解详情,请参阅 有关语言定位变更的博文。