随着新版本的发布,弃用版本的停用日期也会公布,在该日期之后将不再提供弃用版本。下面列出了其他一些需要注意的准则:
- 一次最多可使用三个主要版本。
- 主要版本的生命周期约为 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 控制台查看项目最近调用的方法和服务的列表:
- 在 Google Cloud 控制台中打开 API 和服务。
- 点击表格中的 Google Ads API。
- 在“指标”子标签页中,您应该会看到系统在每个图表中绘制了您的近期请求。您可以在方法表中查看您已向哪些方法发送了请求。方法名称包括 Google Ads API 版本、服务和方法名称,例如
google.ads.googleads.v16.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 版客户端库 |
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 错误。采用“COMMISSION ”出价策略的现有广告系列仍将继续投放,直至 2024 年 10 月 31 日。此后,广告系列将停止投放,直到其出价策略得到更新。
|