弃用和停用

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

• 一次最多只能提供三个主要版本。
• 主要版本的使用期限约为 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 月 24 日	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 Cloud Console 查看您的项目最近调用的方法和服务的列表：

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

弃用和停用的区别

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

支持的客户端库版本

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

Java

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

C#

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

PHP

Google Ads API	PHP 版客户端库
v16	Min: 22.1.0 Max: -
v15	Min: 21.1.0 Max: -

Python

Google Ads API	适用于 Python 的客户端库
v16	Min: 23.1.0 Max: -
v15	Min: 22.1.0 Max: -

Ruby

Google Ads API	适用于 Ruby 的客户端库
v16	Min: 27.0.0 Max: -
v15	Min: 25.0.0 Max: -
v14	Min: 23.0.0 Max: 27.0.0

Perl

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

功能弃用

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

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

特征	说明	生效日期	其他说明
“佣金”出价策略	Google Ads API 不再支持使用COMMISSION出价策略制作酒店广告系列 。	2024 年 4 月 30 日	如果请求制作新的酒店广告系列或将 COMMISSION 出价策略应用于现有广告系列，则会导致 BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED 错误。在 2024 年 10 月 31 日之前，采用“COMMISSION”出价策略的现有广告系列将会继续投放。这一天之后，广告系列将停止投放，直到其出价策略得到更新为止。