版本控制

语义版本控制

Google Ads API 遵循语义版本控制,其中存在 一个大调和一个小版本版本的格式为 MAJOR.MINORvMAJOR_MINOR。例如,v17_0 是主要版本,而 v17_1 是次要版本。

如需了解过往版本,请参阅版本说明

主要版本

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

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

https://googleads.googleapis.com/vX

如果您是从较旧版本的主要版本升级,那么您的代码可能需要 更改。如果您使用的是我们的 客户端库,请升级到最新版本。 一旦有主要版本发布,我们将提供迁移指南, 修复所有破坏性更改

破坏性更改的示例包括:

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

次要版本

次要版本仅引入向后兼容的更改。对于小调版本 vMAJOR_MINOR 会有一个大于零的 MINOR 数字。

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

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

日落

我们会定期弃用较旧的 Google Ads API 版本。我们会发布通知 开发者博客 。通过 弃用时间表已更新,说明了未来弃用时间表 日期。