如何通过REST API在Firestore文档内创建集合？

Firestore 本身不存在单独创建空集合的操作（包括控制台里的"创建集合"，本质也是先创建集合里的第一个文档），所以通过 REST API 实现目标的核心方式是：向目标子集合中添加第一个文档，集合会被自动创建。

具体实现步骤 #

1. 构造请求路径
   子集合的 REST API 路径基于父文档路径拼接，格式如下：
   https://firestore.googleapis.com/v1/projects/[你的项目ID]/databases/(default)/documents/[父集合名]/[父文档ID]/[子集合名]

2. 发送 POST 请求（自动生成文档ID）

   • 请求方法：POST
   • 请求体：按照 Firestore 的字段格式构造文档数据，示例：

     {
       "fields": {
         "name": {"stringValue": "测试订单"},
         "price": {"doubleValue": 29.9}
       }
     }
     

   发送请求后，Firestore 会自动生成文档ID，并创建对应的子集合。

3. 或发送 PUT 请求（指定文档ID）
   如果需要自定义文档ID，将路径补充为：
   https://firestore.googleapis.com/v1/projects/[你的项目ID]/databases/(default)/documents/[父集合名]/[父文档ID]/[子集合名]/[自定义文档ID]

   • 请求方法：PUT
   • 请求体与 POST 方式一致。

关键说明 #

• Firestore 中不存在空集合，只要子集合下有至少一个文档，集合就会被持久化显示；如果删除子集合的所有文档，集合会自动消失。
• 确保请求携带正确的身份认证信息（比如 OAuth2 令牌或服务账号密钥签名的 JWT），否则会返回权限错误。

内容的提问来源于stack exchange，提问作者xcrystal360