弃用和停用

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

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

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

时刻表

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

API 版本 发布日期 停用日期 破坏性更改和升级 功能和更新 Proto 差异表
已发布版本
v23 2026 年 1 月 28 日 2027 年 2 月 v23 破坏性更改（升级指南） v23 功能和更新 v22 与 v23 proto 差异
v23.1 2026 年 2 月 25 日 2027 年 2 月 无（次要版本） v23.1 的功能和更新 v22 与 v23 proto 差异
v23.2 2026 年 3 月 25 日 2027 年 2 月 无（次要版本） v23.2 功能和更新 v22 与 v23 proto 差异
v23.3 2026 年 6 月 24 日 2027 年 2 月 无（次要版本） v23.3 功能和更新 v22 与 v23 proto 差异
v24 2026 年 4 月 22 日 2027 年 5 月 v24 破坏性更改（升级指南） v24 的功能和更新 v23 与 v24 proto 差异
v24.1 2026 年 5 月 13 日 2027 年 5 月 无（次要版本） v24.1 功能和更新 v23 与 v24 proto 差异
v24.2 2026 年 6 月 24 日 2027 年 6 月 无（次要版本） v24.2 功能和更新 v23 与 v24 proto 差异
v25 2026 年 7 月 22 日 2027 年 8 月 v25 破坏性更改（升级指南） v25 的功能和更新 v24 与 v25 proto 差异
v25.1 2026 年 8 月 19 日 2027 年 8 月 无（次要版本） v25.1 的功能和更新 v24 与 v25 proto 差异
v25.2 2026 年 9 月 23 日 2027 年 8 月 无（次要版本） v25.2 的功能和更新 v24 与 v25 proto 差异
v26（最新） 2026 年 10 月 14 日 2027 年 11 月 v26 破坏性更改（升级指南） v26 功能和更新 v25 与 v26 proto 差异
即将推出的版本
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.v26.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 主要版本（例如 v26）的要求。如需查看次要版本所需的客户端库版本，请参阅关联的变更日志。

Java

更新日志

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

C#

更新日志

适用于 .NET 的客户端库
v26 Min: 27.5.0
Max: -
v25 Min: 26.1.0
Max: -
v24 Min: 25.3.0
Max: -
v23 Min: 25.1.0
Max: -

PHP

更新日志

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

Python

更新日志

适用于 Python 的客户端库
v26 Min: 34.0.0
Max: -
v25 Min: 31.2.0
Max: -
v24 Min: 30.1.0
Max: -
v23 Min: 29.2.0
Max: -

Ruby

更新日志

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

Perl

更新日志

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

功能弃用和变更

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

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