语义版本控制
Google Ads API 遵循语义化版本控制,分为主要版本和次要版本。版本的格式为 MAJOR.MINOR
或 vMAJOR_MINOR
。例如,v17_0
是主要版本,而 v17_1
是次要版本。
如需了解过往版本,请参阅版本说明。
主要版本
主要发布版本引入了一些破坏性向后不兼容性更改。版本将以零结尾,格式为 vX_0
,其中 X
是主要版本号。
每个主要版本都有一个单独的端点。这是一个网址示例,其中 X
是主要版本号。
https://googleads.googleapis.com/vX
如果您是从较旧的主要版本升级,那么在切换到新的主要版本端点时,您的代码可能需要更改。如果您使用的是我们的客户端库,请升级至最新版本。当主要版本发布时,我们将提供迁移指南,您应该按照该指南来修复代码中的所有破坏性更改。
破坏性更改的示例包括:
- 移除或重命名服务、接口、字段、方法或枚举值。
- 更改字段类型。
- 更改资源名称格式。
- 更改 HTTP 定义中的网址格式。
- 更改输出格式,例如从
0
更改为--
作为默认值。 - 将返回的错误原因从 A 更改为 B。
次要版本
次要版本仅引入向后兼容的更改。对于次要版本,vMAJOR_MINOR
的 MINOR
数字将大于零。
当发布次要版本时,已在使用的端点将自动更新。这不会导致您的代码被破坏。您可以继续使用现有的客户端库。
次要版本包含不会影响现有代码的新功能或更新。如果要使用这些新功能,请将客户端库升级到最新版本。
日落
我们会定期弃用较旧的 Google Ads API 版本。当某个版本即将弃用时,我们会在开发者博客上发布通知。弃用时间表会更新为未来的停用日期。