弃用和停用

随着新版本的发布，弃用 版本也会公布停用日期，在该日期之后将不再 提供该版本。请注意以下几点其他指导原则：

• 我们力求在任何时候都提供不超过 4 个主要版本。 __
• 主要版本的生命周期约为 12 个月；次要版本 的生命周期为 10 个月。
• 您每年最多需要执行两次升级，并且不必 按严格的顺序升级，例如，您可以 从版本 (N) 直接升级到版本 (N+2)。
• 最新版本的所有客户端库的发布日期与要停用的版本之间的重叠时间至少为 20 周。

我们的 客户端库 支持服务的任何可用版本，因此您可以通过指定所用服务的不同版本来逐步升级。

时刻表

下表列出了每个可用版本的具体弃用和停用日期，以及未来版本的预计发布日期。我们建议您在最新版本发布后尽快进行升级。“暂定日期”表示停用可能会在该月的任何时间发生，并且日期可能会发生变化。 订阅博客 接收 API 版本弃用公告提醒。

API 版本	发布日期	停用日期	升级指南
已发布版本
v20	2025 年 6 月 4 日	2026 年 6 月（暂定）	从 v19 升级到 v20
v20.1	2025 年 8 月 6 日	2026 年 6 月（暂定）	从 v19 升级到 v20
v21	2025 年 8 月 6 日	2026 年 8 月（暂定）	从 v20 升级到 v21
v22	2025 年 10 月 15 日	2026 年 10 月（暂定）	从 v21 升级到 v22
v23	2026 年 1 月 28 日	2027 年 2 月	从 v22 升级到 v23
即将推出的版本
v23.1	2026 年 2 月 25 日	2027 年 2 月	从 v23 升级到 v23.1
v23.2	2026 年 3 月 25 日	2027 年 2 月	从 v23.1 升级到 v23.2
v24	2026 年 4 月	2027 年 5 月
v24.1	2026 年 5 月	2027 年 5 月
v24.2	2026 年 6 月	2027 年 5 月
v25	2026 年 7 月	2027 年 8 月
v25.1	2026 年 8 月	2027 年 8 月
v25.2	2026 年 9 月	2027 年 8 月
v26	2026 年 10 月	2027 年 11 月
v26.1*	2026 年 11 月	2027 年 11 月

* 由于与节日季重叠，v26.1 被指定为可选版本。

查看您的项目正在使用的版本

您可以使用 Google Cloud 控制台查看您的项目最近调用的方法和服务列表：

1. 在 Google Cloud 控制台中打开 API 和服务 。
2. 点击表格中的 Google Ads API 。
3. 在指标 子标签页上，您应该会看到最近的请求绘制在每个图表上。您可以在方法 表格中查看您已向哪些方法发送请求。方法名称包含 Google Ads API 版本、服务和方法名称，例如 google.ads.googleads.v23.services.GoogleAdsService.Mutate。
4. （可选）选择要查看请求的时段。

弃用和停用的区别

术语	弃用	停用
定义	弃用版本是指 不是最新版本 的版本。 新版本发布后，所有先前版本都将被标记为 已弃用 。	停用版本 无法再使用 。发送到此 版本 的请求将在停用日期当天或之后失败。
影响	您仍然可以使用已弃用的版本，直到它们停用为止，但已弃用版本的引用会以浅色显示，以表明它们不再是最新版本。 我们建议您尽快升级到最新版本，以 享受新功能。	您需要 立即 从停用版本升级，才能使用 Google Ads API。 我们 强烈建议 您使用 升级指南 升级到 最新 版本 。
时间	我们平均每 3 到 4 个月发布一个新版本，因此给定的 版本将在大约 3 到 4 个月后被弃用。	我们的目标是在版本发布 1 年后将其停用。
API	已弃用版本的 API 端点 仍可照常运行。 您可以使用我们的客户端库、REST 等 访问我们的 API 端点；但是，新功能不会添加到已弃用的版本中。	停用版本的 API 端点在停用日期之后 停止运行。如果您尝试访问停用版本的 API 端点，Google Ads API 将抛出错误。
客户端库	为了提供紧凑的客户端库，我们 将停止 包含弃用日期之后的新客户端库版本中的已弃用 API 版本。这有助于您在项目中加入 我们的客户端库时节省空间。	在停用日期之后，客户端库 不再支持 任何新客户端库版本中的停用 API 版本。
支持	我们为已弃用的版本提供常规支持。	在停用日期之后，不再支持停用版本。

支持的客户端库版本

该表显示了哪些客户端库适用于哪些 API 版本。

功能弃用

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

下表列出了计划在 Google Ads API 中弃用的具体功能。如需详细了解每项弃用，请参阅链接的博客文章。

功能	说明	生效日期	其他说明
目标客户匹配支持方面的变更	自 2026 年 4 月 1 日起，没有近期 目标客户匹配请求的开发者令牌必须使用 Data Manager API 来执行目标客户 匹配工作流程。 如果您的开发者令牌在 2025 年 10 月 1 日至 2026 年 3 月 31 日期间为目标客户匹配受众群体发送了 OfflineUserDataJobService 或 UserDataService 请求，则可以继续将您的开发者令牌与 Google Ads API 搭配使用来执行目标客户匹配工作流程。不过，我们建议您将目标客户匹配工作流程升级到 Data Manager API，以获得更好的开发者体验并使用更多功能。 否则，自 2026 年 4 月 1 日起，任何 OfflineUserDataJobService 或 UserDataService 针对目标客户匹配受众群体的请求都将失败，并显示错误 CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE. 请改用 Data Manager API 来执行目标客户匹配工作流程，而不是 Google Ads API 。	2026 年 4 月 1 日	如需了解详情，请参阅 我们的博客文章 。
IP 地址和会话属性支持方面的变更	自 2026 年 2 月 2 日起，Google Ads API 将不再接受 新用户在转化导入过程中使用会话属性或 IP 地址数据。现有用户应迁移到 Data Manager API。	2026 年 2 月 2 日	如需了解详情，请参阅 我们的博客文章。
来电专用广告弃用	自 2026 年 1 月起，无法再制作新的来电专用广告。现有 来电专用广告将于 2027 年 2 月停止投放，并且 API 支持将被 移除。广告客户应改用包含电话素材资源的自适应搜索广告 ，而不是使用其他广告。	2026 年 1 月	如需了解详情，请参阅 我们的博客文章。