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 群组上发布通知。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-09-10。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"没有我需要的信息"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"太复杂/步骤太多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"内容需要更新"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻译问题"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/代码问题"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"易于理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"解决了我的问题"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]
{"lastModified": "\u6700\u540e\u66f4\u65b0\u65f6\u95f4 (UTC)\uff1a2024-09-10\u3002"}
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["没有我需要的信息","missingTheInformationINeed","thumb-down"],["太复杂/步骤太多","tooComplicatedTooManySteps","thumb-down"],["内容需要更新","outOfDate","thumb-down"],["翻译问题","translationIssue","thumb-down"],["示例/代码问题","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2024-09-10。"]]