弃用和停用

随着新版本的发布,弃用版本的停用日期也会公布,在该日期之后将不再提供弃用版本。下面列出了其他一些需要注意的准则:

  • 一次最多可使用三个主要版本
  • 主要版本的生命周期约为 12 个月;次要版本的生命周期约为 10 个月。
  • 您每年最多只能执行两次升级,且无需按严格的顺序升级。例如,您可以从版本 (N) 直接升级到版本 (N+2)。
  • 从最新版本的所有客户端库发布到弃用的版本之间的重叠时间至少为 20 周。

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

时刻表

下表列出了每个可用版本的具体弃用和停用日期以及未来版本的预计发布日期。我们建议您在最新版本发布后尽快升级到最新版本。

API 版本 发布日期 弃用日期 停用日期 升级指南
v18 2024 年 9 月/10 月 2025 年 1 月/2 月 2025 年 9 月
v17.1 2024 年 7 月/8 月 2024 年 9 月/10 月 2025 年 5 月
v17 2024 年 5 月/6 月 2024 年 9 月/10 月 2025 年 5 月
v16.1 2024 年 4 月/5 月 2024 年 5 月/6 月 2025 年 1 月
v16 2024 年 2 月 21 日 2024 年 5 月/6 月 2025 年 1 月
v15 2023 年 10 月 18 日 2024 年 2 月 21 日 2024 年 9 月 25 日 从 v15 升级到 v16
v14.1 2023 年 8 月 9 日 2023 年 10 月 18 日 2024 年 6 月 5 日
v14 2023 年 6 月 7 日 2023 年 10 月 18 日 2024 年 6 月 5 日 从 v14 升级到 v15

弃用和停用的区别

术语弃用落日余晖
定义 已弃用的版本不是最新版本。当新版本发布后,所有以前的版本都将标记为已弃用 弃用版本无法再使用。发送到此版本的请求将在弃用日期当天或之后失败。
影响 在已弃用版本停用之前,您仍然可以使用它们,但系统不会突出显示对已弃用版本的引用,以表明它们不再是最新版本。

我们建议您尽快升级到最新版本,以享受新功能。

您需要立即从弃用版本升级,才能使用 Google Ads API。

我们强烈建议您按照升级指南升级到最新版本

计时 平均而言,我们每 3 到 4 个月发布一次新版本,因此指定版本会在大约 3 到 4 个月后弃用。 我们计划在某个版本发布后 8 到 10 个月将其停用。
API 已弃用版本的 API 端点仍可照常运行

您可以使用我们的客户端库、REST 等访问我们的 API 端点;不过,已弃用的版本中不会添加新功能。

在弃用日期之后,弃用版本的 API 端点将停止运行。如果您尝试访问已弃用版本的 API 端点,Google Ads API 将抛出错误。
客户端库 为了提供紧凑的客户端库,在弃用日期之后,我们将停止在新客户端库版本中包含已弃用的 API 版本。将我们的客户端库纳入项目中时,这有助于节省空间。 在弃用日期之后,客户端库不再支持任何新客户端库版本中已弃用的 API 版本。
支持 我们会为已弃用的版本提供定期支持。 在弃用日期之后,弃用版本不再受支持

支持的客户端库版本

下表显示了哪些客户端库支持哪些 API 版本。

Java

Java 版客户端库
v16 Min: 30.0.0
Max: -
v15 Min: 28.0.0
Max: -
v14 Min: 26.0.0
Max: -

C#

适用于 .NET 的客户端库
v16 Min: 18.1.0
Max: -
v15 Min: 17.1.0
Max: -
v14 Min: 16.1.0
Max: -

PHP

PHP 版客户端库
v16 Min: 22.1.0
Max: -
v15 Min: 21.1.0
Max: -
v14 Min: 19.2.0
Max: -

Python

适用于 Python 的客户端库
v15 Min: 22.1.0
Max: -
v14 Min: 21.2.0
Max: -

Ruby

Ruby 版客户端库
v16 Min: 27.0.0
Max: -
v15 Min: 25.0.0
Max: -
v14 Min: 23.0.0
Max: -

Perl

适用于 Perl 的客户端库
v16 Min: 21.0.0
Max: -
v15 Min: 19.0.0
Max: -
v14 Min: 17.0.0
Max: -

功能弃用

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

下表列出了目前计划针对 Google Ads API 弃用的具体功能。如需详细了解每项弃用,请参阅链接的博文。

特征 说明 生效日期 其他说明