AIP-2 AIP编号规则
·
[tommwq@126.com]
| 编号 | 2 |
|---|---|
| 原文链接 | https://google.aip.dev/2 |
| 状态 | 批准 |
| 创建日期 | 2018-08-23 |
| 更新日期 | 2018-08-23 |
AIP系统提供了用于索引和作为API改进议案单一事实来源的机制，以协作和透明的方式改进AIP。
本文档描述了AIP编号系统。
分配AIP编号
当AIP成为审查草案时，编辑者（见AIP-1）负责为其分配编号。要注意， 所有 （不仅仅是已批准的）AIP都有编号。AIP索引明确标注了哪些AIP是已批准的、具有约束力的，哪些是还在讨论中的。
编辑者可以为一些关联的AIP（例如仅适用于特定API子集的AIP）预留特定的编号范围。
除此之外，AIP编号可以任意分配。通常编辑者会编号清单中取出下一个编号分配给AIP草案，但有时也可能使用特殊编号，为了便于记忆或其他原因。
AIP编号范围
目前已分配的AIP编号范围包括：
通用
- 1-99: 基础AIP（通常与流程相关）
- 100-999: 通用API设计指南
Google产品领域
- 2700-2799: 应用（Google Workspace）
- 2500-2599: 云
- 3000-3099: Actions on Google
- 3200-3299: Firebase
- 4100-4199: 认证库
- 4200-4299: 客户端库
- 4600-4699: 地理
如果需要为特定团队发布的API指南或文档预留编号范围，请联系编辑者。
修订记录
- 2019-10-03: 将3000-3099编号范围分配给Actions on Google。
- 2019-01-26: 将通用API设计指南编号范围扩展至100-199。
- 2018-10-24: 将4600-4699编号范围分配给Google Geo。
- 2018-10-02: 将2500-2599编号范围分配给Google云平台。
- 2018-10-02: 将2700-2799编号范围分配给Google Workspace。