仅支持结构化查询FIRESTORE API REST

基础概念

Firestore 是 Google Firebase 提供的一种 NoSQL 数据库服务，它是一个高度伸缩的、为 web、iOS 和 Android 应用设计的 JSON 文档数据库。Firestore API 允许开发者通过 RESTful 接口与 Firestore 数据库进行交互，执行数据的读取、写入、更新和删除操作。

优势

实时数据同步：Firestore 支持实时数据同步，当数据发生变化时，所有客户端都会立即收到更新。
离线支持：Firestore 客户端库可以在设备离线时继续工作，并在重新连接后自动同步数据。
安全规则：Firestore 提供了强大的安全规则，允许开发者定义谁可以访问哪些数据，以及在什么条件下可以访问。
可扩展性：Firestore 设计用于处理大量数据和高并发请求，能够随着应用的增长而轻松扩展。
灵活性：由于 Firestore 是一个 NoSQL 数据库，它提供了灵活的数据模型，允许开发者根据应用需求自由设计数据结构。

类型

Firestore 数据库中的数据以文档（Documents）的形式存储，每个文档包含一组键值对（Fields）。文档可以嵌套在其他文档中，形成类似树状的结构。此外，Firestore 还支持集合（Collections），集合是文档的容器，可以包含多个文档。

应用场景

移动应用：Firestore 的实时数据同步和离线支持使其非常适合移动应用，能够提供流畅的用户体验。
Web 应用：对于 Web 应用，Firestore 提供了一个简单易用的 API，可以快速实现数据的存储和检索。
实时协作应用：由于 Firestore 支持实时数据同步，因此非常适合开发实时协作应用，如在线文档编辑器、聊天应用等。
物联网应用：Firestore 可以用于存储和处理来自物联网设备的数据，支持实时监控和分析。

遇到的问题及解决方法

问题：为什么 Firestore API REST 请求返回 403 Forbidden 错误？

原因：这个错误通常是由于权限不足或安全规则配置不正确导致的。Firestore 使用安全规则来控制对数据的访问，如果请求不符合规则，就会返回 403 错误。

解决方法：

检查安全规则：确保你的 Firestore 安全规则允许当前请求的操作。例如，如果你需要读取某个集合的数据，确保规则中允许读取该集合。
验证身份：如果你的请求需要身份验证，请确保你已经正确设置了身份验证，并且请求中包含了有效的身份验证令牌。

示例安全规则：

service cloud.firestore {
  match /databases/{database}/documents {
    match /{document=**} {
      allow read, write: if request.auth != null;
    }
  }
}

这个规则表示只有经过身份验证的用户才能读取和写入数据。

问题：如何处理 Firestore API REST 请求中的分页？

解决方法：

Firestore API 支持使用 startAfter 或 endBefore 参数来实现分页。你可以指定一个文档作为分页的起点或终点，从而获取下一页或上一页的数据。

示例代码：

GET https://firestore.googleapis.com/v1/projects/{project_id}/databases/(default)/documents/collection_name?orderBy="field_name"&startAfter="document_id"

这个请求将返回 collection_name 集合中 field_name 字段排序后，从 document_id 文档之后的数据。