Search Ads 360 Reporting API 中的版本控制

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 群组上发布通知。