弃用和停用

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

  • 一次最多只能提供三个主要版本
  • 主要版本的使用期限约为 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 年 6 月 5 日 2025 年 1 月 从 v16 升级到 v17
v16 2024 年 2 月 21 日 2024 年 6 月 5 日 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. 指标子标签上,您应该会看到您最近的请求绘制于 每个图表。您可以在 方法表中。方法名称 包括 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 日。此后 广告系列将停止投放,直到其出价策略得到更新为止。