Search Ads 360 Reporting API 使用语义版本控制。
有主要版本和次要版本，格式为 vMAJOR_MINOR。例如，v0_0 是第一个主要版本，v0_1 是第一个次要版本。版本号的后缀表示版本类型：对于主要版本，版本号始终为零；对于次要版本，版本号始终大于零。
主要版本
主要版本引入了破坏性更改，即不向后兼容的更改。
每个主要版本都有单独的端点，例如：
https://searchads360.googleapis.com/v0 https://searchads360.googleapis.com/v1
从一个主要版本升级到另一个主要版本时，您可能需要在切换到新的主要版本端点之前更改代码。
如果您使用客户端库，则需要升级到最新版本。新的主要版本提供了迁移指南，可帮助您修复代码中的所有重大更改。
破坏性更改的示例包括：
- 移除或重命名服务、接口、字段、方法或枚举值。
- 更改字段类型。
- 更改资源名称格式。
- 更改 HTTP 定义中的网址格式。
- 更改输出格式，例如将
0更改为--作为默认值。 - 将返回的错误原因从 A 更改为 B。
次要版本
次要版本仅引入向后兼容的更改。
当次要版本发布后，已使用的端点会自动更新。这不会导致代码中断。您可以继续使用现有的客户端库。
次要版本包含不会影响现有代码的新功能或更新。如果要使用新功能，您需要将客户端库升级到最新版本。
日落
当我们计划停用旧版 Search Ads 360 Reporting API 时，我们会在 searchads-api-announcements Google 网上论坛上发布通知。