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