版本控制

语义版本控制

Google Ads API 遵循主要版本和次要版本语义版本控制。版本格式为 MAJOR.MINORvMAJOR_MINOR。例如,v11_0 是主要版本,而 v11_1 是次要版本。

请参阅以往版本的版本说明

主要版本

主要发布版本引入了一些向后不兼容的破坏性更改。版本将以 0 结尾,格式为 vX_0,其中 X 是主要版本号。

每个主要版本都有一个单独的端点。这是一个网址示例,其中 X 是主要版本号。

https://googleads.googleapis.com/vX

如果您要从旧版 Major 版本升级,那么在切换到新的 Major 版本端点后,您的代码可能需要进行更改。如果您使用的是我们的客户端库,请升级到最新版本。当有主要版本发布时,我们将提供一份迁移指南,引导您完成修复代码中任何重大更改的操作。

重大变更示例包括:

  • 移除或重命名服务、接口、字段、方法或枚举值。
  • 更改字段的类型。
  • 更改资源名称格式。
  • 更改 HTTP 定义中的网址格式。
  • 更改输出格式,例如将默认值从 0 更改为 --
  • 将错误原因从 A 更改为 B。

次要版本

次要版本仅引入向后兼容的更改。对于次要版本,vMAJOR_MINORMINOR 数字大于零。

次要版本发布时,已在使用的端点会自动更新。这不会导致您的代码损坏。您可以继续使用现有客户端库。

次要版本包括不会影响现有代码的新功能或更新。如果您想使用这些新功能,请将客户端库升级到最新版本。

日落

旧版 Google Ads API 会定期停用。当某个版本即将停用时,我们会在开发者博客上发布通知。弃用时间表会更新为未来的停用日期。