随着新版本的发布，弃用版本的停用日期也会公布，在该日期之后将不再提供弃用版本。请注意以下其他准则：
- 任何时候都最多只能有 三个主要版本。
- 主要版本的生命周期约为 12 个月；次要版本：10 个月。
- 每年您最多只能执行两次升级，并且不必严格按顺序进行升级，例如，您可以从版本 (N) 直接升级到版本 (N+2)。
- 为最新版本发布所有客户端库的日期与要弃用的版本之间的重叠期至少为 20 周。
我们的客户端库支持服务的任何可用版本，因此您可以通过指定所用服务的不同版本来逐步升级。
时刻表
下表列出了每个可用版本的具体弃用和停用日期，以及未来版本的预计发布日期。我们建议您在最新版本发布后尽快升级到该版本。
| API 版本 | 发布日期 | 弃用日期 | 停用日期 | 升级指南 |
|---|---|---|---|---|
| v18 | 2024 年 10 月 16 日 | 2025 年 2 月 | 2025 年 9 月 24 日 | |
| v17.1 | 2024 年 8 月 7 日 | 2024 年 9 月/10 月 | 2025 年 6 月 4 日 | 从 v17 升级到 v18 |
| v17 | 2024 年 6 月 5 日 | 2024 年 9 月/10 月 | 2025 年 6 月 4 日 | 从 v17 升级到 v18 |
| v16.1 | 2024 年 4 月 24 日 | 2024 年 6 月 5 日 | 2025 年 2 月 5 日 | 从 v16 升级到 v17 |
| v16 | 2024 年 2 月 21 日 | 2024 年 6 月 5 日 | 2025 年 2 月 5 日 | 从 v16 升级到 v17 |
查看项目使用的版本
您可以使用 Google Cloud 控制台查看项目最近调用的方法和服务的列表：
- 在 Google Cloud 控制台中打开 API 和服务。
- 点击表格中的 Google Ads API。
- 在METRICS子标签页上，您应该会看到最近请求绘制在每个图表上。您可以在方法表中查看已向哪些方法发送请求。方法名称包含 Google Ads API 版本、服务和方法名称，例如
google.ads.googleads.v18.services.GoogleAdsService.Mutate。 - （可选）选择要查看请求的时间范围。
废弃和弃用的区别
| 术语 | 弃用 | 落日余晖 |
|---|---|---|
| 定义 | 已弃用版本是指不是最新版本的版本。一旦发布新版本，所有先前版本都将标记为已弃用。 | 已弃用的版本无法再使用。发送到此版本的请求将在停用日期当天或之后失败。 |
| 影响 | 在弃用之前，您仍然可以使用已废弃的版本，但已废弃版本的引用会取消突出显示，以表明它们已不是最新版本。
我们建议您尽快升级到最新版本，以便获享新功能。 |
您需要立即从弃用版本升级，才能使用 Google Ads API。
我们强烈建议您使用升级指南升级到最新版本。 |
| 计时 | 平均而言，我们每 3 到 4 个月发布一个新版本，因此给定版本大约会在 3 到 4 个月后被弃用。 | 我们的目标是在版本发布 1 年后停用该版本。 |
| API | 已废弃版本的 API 端点仍会照常运行。
您可以使用我们的客户端库、REST 等访问我们的 API 端点；不过，我们不会向已废弃的版本添加新功能。 |
在停用日期之后，停用版本的 API 端点会停止运行。如果您尝试访问已弃用版本的 API 端点，Google Ads API 将抛出错误。 |
| 客户端库 | 为了提供紧凑的客户端库，在弃用日期之后，我们将停止在新的客户端库版本中包含已弃用的 API 版本。这有助于您在将我们的客户端库纳入项目时节省空间。 | 在弃用日期之后，任何新客户端库版本中的客户端库都不再支持所弃用的 API 版本。 |
| 支持 | 我们会为已弃用的版本提供定期支持。 | 在停用日期过后，已停用的版本将不再受支持。 |
支持的客户端库版本
下表显示了哪些客户端库与哪些 API 版本配合使用。
Java
Google Ads API |
Java 版客户端库 |
v18 |
Min: 34.0.0Max: - |
v17 |
Min: 32.0.0Max: - |
v16 |
Min: 30.0.0Max: - |
C#
Google Ads API |
适用于 .NET 的客户端库 |
v18 |
Min: 21.1.0Max: - |
v17 |
Min: 20.1.0Max: - |
v16 |
Min: 18.1.0Max: - |
PHP
Google Ads API |
PHP 版客户端库 |
v18 |
Min: 25.0.0Max: - |
v17 |
Min: 23.1.0Max: - |
v16 |
Min: 22.1.0Max: - |
Python
Google Ads API |
适用于 Python 的客户端库 |
v18 |
Min: 25.1.0Max: - |
v17 |
Min: 24.1.0Max: - |
v16 |
Min: 23.1.0Max: - |
Ruby
Google Ads API |
Ruby 版客户端库 |
v18 |
Min: 31.0.0Max: - |
v17 |
Min: 29.0.0Max: - |
v16 |
Min: 27.0.0Max: - |
Perl
Google Ads API |
适用于 Perl 的客户端库 |
v18 |
Min: 25.0.0Max: - |
v17 |
Min: 23.0.0Max: - |
v16 |
Min: 21.0.0Max: - |
功能弃用
定期查看 Google Ads 开发者博客，抢先了解即将弃用的功能。
下表列出了目前计划针对 Google Ads API 弃用的具体功能。如需详细了解每项弃用，请参阅链接的博文。
| 功能 | 说明 | 生效日期 | 其他说明 |
|---|---|---|---|
| Google Ads API 中的页面大小即将发生变化 | 在 v16 弃用后，您将无法再在发出 GoogleAdsService.Search 请求时设置 page_size 字段。 |
2025 年 1 月 | 停用 v16 后，所有 GoogleAdsService.Search 请求都将默认采用 10,000 行的固定页面大小。 |
| “智能点击付费”出价策略 | Google Ads API 不再支持将智能点击付费设置为搜索广告系列和展示广告系列的出价策略。 | 2024 年 10 月 |
在出价策略中将 enhanced_cpc_enabled 字段设置为 TRUE 的请求将导致 BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED 错误。在 2025 年 3 月 15 日之前，采用“智能点击付费”出价策略的现有广告系列仍可继续投放。在此日期之后，系统将自动将这些广告系列改用“每次点击费用人工出价”出价策略。
|