版本控制

目标： 了解 Google Ads API 版本控制的运作方式。

语义版本控制

Google Ads API 遵循语义版本控制，其中包含主要版本和次要版本。版本格式为 MAJOR.MINOR 或 vMAJOR_MINOR。例如，v24_0 是主要版本，而 v24_1 是次要版本。

如需查看过往版本的版本说明，请参阅版本说明。

主要版本

主要版本会引入一些重大且向后不兼容的更改。版本号将以零结尾，格式为 vX_0，其中 X 是主要版本号。

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

https://googleads.googleapis.com/vX

如果您是从旧的主要版本升级，那么在切换到新的主要版本端点时，您的代码可能需要进行更改。如果您使用的是我们的客户端库，请升级到最新版本。当有主要版本发布时，我们会提供迁移指南，您应仔细阅读该指南，以修复代码中的任何重大变更。

重大更改的示例包括：

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

次要版本

次要版本只会引入向后兼容的更改。对于次要版本，vMAJOR_MINOR 的 MINOR 数值会大于零。

发布次要版本后，正在使用的端点会自动更新。这不会导致您的代码中断。您可以继续使用现有客户端库。

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

日落

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