Method: projects.databases.documents.list

string

必需。父级资源名称。格式为：projects/{projectId}/databases/{databaseId}/documents 或 projects/{projectId}/databases/{databaseId}/documents/{document_path}。

例如：projects/my-project/databases/my-database/documents 或 projects/my-project/databases/my-database/documents/chatrooms/my-chatroom

string

可选。要列出的集合 ID（相对于 parent）。

例如：chatrooms 或 messages。

这是可选内容；如果未提供，Firestore 将列出提供的 parent 下所有集合中的文档。

integer

可选。单个响应中要返回的文档数量上限。

Firestore 返回的值可能少于此值。

string

可选。从之前的 documents.list 响应中收到的页面令牌。

提供此令牌以检索后续页面。进行分页时，所有其他参数（pageSize 除外）必须与在生成页面令牌的请求中设置的值一致。

string

可选。要返回的文档的可选顺序。

例如：priority desc, __name__ desc。

这镜像了 Firestore 查询中使用的 ORDER BY，但采用字符串表示形式。如果没有，将根据 __name__ ASC 对文档进行排序。

object (DocumentMask)

可选。要返回的字段。如果未设置，则返回所有字段。

如果文档的某个字段不在此掩码中，则不会在响应中返回该字段。

boolean

列表是否应显示缺失的文档。

如果某个文档不存在，但该文档下面嵌套了子文档，则它就会丢失。如果为 true，则返回此类缺失的文档时将附带一个键，但不会设置任何字段、createTime 或 updateTime。

带有 showMissing 的请求不能指定 where 或 orderBy。

string (bytes format)

作为已活跃事务的一部分执行读取。

使用 base64 编码的字符串。

string (Timestamp format)

在提供的时间执行读取操作。

此时间戳必须是过去一小时内的微秒级精确时间戳；如果启用了时间点恢复，也可以是过去 7 天内的整分钟时间戳。

采用 RFC3339 世界协调时间 (UTC)（即“祖鲁时”）格式的时间戳，采用纳秒级精度，最多包含九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。