弃用和停用

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

  • 我们力求在任何时候都提供最多五个主要版本。 __
  • 主要版本的使用期限约为 12 个月；次要版本 的使用期限为 10 个月。
  • 您每年最多需要执行两次升级，并且不必 严格按照顺序升级，例如，您可以 直接从版本 (N) 升级到版本 (N+2)。

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

时刻表

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

API 版本发布日期停用日期升级指南
已发布版本
v222025 年 10 月 15 日2026 年 10 月从 v21 升级到 v22
v232026 年 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 月 22 日 2027 年 5 月 从 v23.2 升级到 v24
v24.1 2026 年 5 月 13 日 2027 年 5 月 从 v24 升级到 v24.1
v24.2 2026 年 6 月 24 日 2027 年 6 月 从 v24.1 升级到 v24.2
v25 2026 年 7 月 22 日 2027 年 8 月 从 v24.2 升级到 v25
v25.1 2026 年 8 月 19 日 2027 年 8 月 从 v25 升级到 v25.1
v25.2 2026 年 9 月 23 日 2027 年 8 月 从 v25.1 升级到 v25.2
即将发布的版本
v26 2026 年 10 月 2027 年 11 月  
v26.1 2026 年 10 月 2027 年 11 月  
v26.2 2026 年 11 月 2027 年 11 月  
v26.3* 2026 年 12 月 2027 年 11 月  
v27 2027 年 1 月 2028 年 2 月  
v27.1 2027 年 2 月 2028 年 2 月  
v27.2 2027 年 2 月 2028 年 2 月  
v27.3 2027 年 3 月 2028 年 2 月  
v27.4 2027 年 3 月 2028 年 2 月  
v28 2027 年 4 月 2028 年 5 月  
v28.1 2027 年 4 月 2028 年 5 月  
v28.2 2027 年 5 月 2028 年 5 月  
v28.3 2027 年 5 月 2028 年 5 月  
v28.4 2027 年 6 月 2028 年 5 月  
v28.5 2027 年 6 月 2028 年 5 月  
v29 2027 年 7 月 2028 年 8 月  
v29.1 2027 年 7 月 2028 年 8 月  
v29.2 2027 年 8 月 2028 年 8 月  
v29.3 2027 年 8 月 2028 年 8 月  
v29.4 2027 年 9 月 2028 年 8 月  
v29.5 2027 年 9 月 2028 年 8 月  
v30 2027 年 10 月 2028 年 11 月  
v30.1 2027 年 10 月 2028 年 11 月  
v30.2 2027 年 11 月 2028 年 11 月  
v30.3* 2027 年 12 月 2028 年 11 月  

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

查看项目使用的版本

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

  1. 在 Google Cloud 控制台中打开 API 和服务 。
  2. 在表格中点击 Google Ads API 。
  3. 在指标 子标签页上，您应该会在每个图表上看到最近的请求。您可以在方法 表格中查看已向哪些方法发送请求。方法名称包含 Google Ads API 版本、服务和方法名称，例如 google.ads.googleads.v25.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 API 主要版本（例如 v25）的要求。如需查看次要版本所需的客户端库版本，请参阅链接的更新日志。

Java

更新日志

Java 版客户端库
v25 Min: 44.0.0
Max: -
v24 Min: 43.0.0
Max: -
v23 Min: 42.0.0
Max: -

C#

更新日志

.NET 版客户端库
v25 Min: 26.1.0
Max: -
v24 Min: 25.3.0
Max: -
v23 Min: 25.1.0
Max: -

PHP

更新日志

PHP 版客户端库
v25 Min: 33.6.0
Max: -
v24 Min: 33.3.0
Max: -
v23 Min: 32.2.0
Max: -

Python

更新日志

Python 版客户端库
v25 Min: 31.2.0
Max: -
v24 Min: 30.1.0
Max: -
v23 Min: 29.2.0
Max: -

Ruby

更新日志

Ruby 版客户端库
v25 Min: 43.0.0
Max: -
v24 Min: 40.0.0
Max: -
v23 Min: 38.0.0
Max: -

Perl

更新日志

Perl 版客户端库
v25 Min: 33.0.0
Max: -
v24 Min: 32.0.0
Max: -
v23 Min: 31.0.0
Max: -

功能弃用和变更

虽然此页面侧重于 API 版本级生命周期，但个别功能弃用（例如智能广告系列弃用）和无版本工作流变更（例如新的需求开发广告系列预算要求）会单独跟踪。

如需查看即将推出的功能生命周期和活跃 版本中的行为变化，请参阅 功能弃用和无版本变更指南。