弃用和停用

随着新版本的发布，已弃用的 规定了弃用日期，在该日期之后，该版本将不再 可用。以下是一些需要注意的其他准则：

  • 一次最多只能提供三个主要版本。
  • 主要版本的使用期限约为 12 个月，次要版本： 10 个月。
  • 您每年最多只能执行两次升级，并且没有 必须严格地依序升级，例如，您可以 从版本 (N) 直接更新到版本 (N+2)。
  • 针对 最新版本，而待弃用的版本至少持续 20 周。

我们的客户端库可支持 因此，您可以通过为常用服务指定 服务。

时刻表

下表列出了每项服务的具体弃用和停用日期 可用版本，以及未来版本的预计发布日期。周三 建议您在下载完毕之后尽快升级到 发布。

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

查看项目使用的版本

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

  1. 打开 API 和服务。
  2. 点击表格中的 Google Ads API。
  3. 在METRICS子标签上，您应该会看到您最近的请求绘制于 每个图表。您可以在 Methods 表格。方法名称 包括 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 端点。
客户端库 为了提供紧凑的客户端库，我们将不再提供 在新的客户端库版本中加入已弃用的 API 版本 。这有助于您在合并广告素材时节省空间 客户端库 <ph type="x-smartling-placeholder"> 客户端库不再支持下列国家/地区中已弃用的 API 版本： 停用日期之后的任何新客户端库版本。
支持 我们会为已弃用的版本提供定期支持。 在弃用之后，已弃用的版本不再受支持 日期。

支持的客户端库版本

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

Java

Java 版客户端库
v17 Min: 32.0.0
Max: -
v16 Min: 30.0.0
Max: -
v15 Min: 28.0.0
Max: 32.0.0

C#

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

PHP

PHP 版客户端库
v17 Min: 23.1.0
Max: -
v16 Min: 22.1.0
Max: -
v15 Min: 21.1.0
Max: 23.1.0

Python

适用于 Python 的客户端库
v17 Min: 24.1.0
Max: -
v16 Min: 23.1.0
Max: -
v15 Min: 22.1.0
Max: -

Ruby

适用于 Ruby 的客户端库
v17 Min: 29.0.0
Max: -
v16 Min: 27.0.0
Max: -
v15 Min: 25.0.0
Max: -

Perl

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

功能弃用

定期监控 Google Ads 开发者博客 第一时间获悉即将弃用的功能。

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

功能 说明 生效日期 其他说明
“佣金”出价策略 Google Ads API <ph type="x-smartling-placeholder"></ph> 不再支持制作COMMISSION酒店广告系列 出价策略 。 2024 年 4 月 30 日 请求制作新的酒店广告系列或应用COMMISSION 出价策略的效果 BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED 错误。采用“COMMISSION”出价的现有广告系列 策略将持续运行至 2024 年 10 月 31 日。此后 广告系列将停止投放，直到其出价策略得到更新为止。