Muestra una lista de documentos.
Solicitud HTTP
GET https://firestore.googleapis.com/v1/{parent=projects/*/databases/*/documents/*/**}/{collectionId}
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
parent |
Obligatorio. El nombre del recurso superior. En el formato: Por ejemplo, |
collectionId |
Opcional. El ID de colección, en relación con Por ejemplo, Esto es opcional y, cuando no se proporcione, Firestore mostrará una lista de los documentos de todas las colecciones en el |
Parámetros de consulta
Parámetros | |
---|---|
pageSize |
Opcional. La cantidad máxima de documentos que se mostrarán en una sola respuesta. Firestore puede mostrar menos que este valor. |
pageToken |
Opcional. Un token de página, recibido de una respuesta anterior de Proporciona esto para recuperar la página siguiente. Cuando se realiza la paginación, todos los demás parámetros (excepto |
orderBy |
Opcional. El orden opcional de los documentos que se mostrarán. Por ejemplo: Esto duplica el |
mask |
Opcional. Los campos que se deben mostrar. Si no se configura, muestra todos los campos. Si un documento tiene un campo que no está presente en esta máscara, ese campo no se mostrará en la respuesta. |
showMissing |
Si la lista debe mostrar los documentos que faltan. Falta un documento si no existe, pero hay subdocumentos anidados debajo. Si es verdadero, los documentos faltantes se mostrarán con una clave, pero no tendrán campos ni campos Las solicitudes con |
Es el parámetro de unión consistency_selector . El modo de coherencia para esta transacción. Si no está configurado, se establece de forma predeterminada para una coherencia sólida. Las direcciones (consistency_selector ) solo pueden ser una de las siguientes opciones: |
|
transaction |
Realiza la lectura como parte de una transacción ya activa. String codificada en base64. |
readTime |
Realiza la lectura en el momento indicado. Debe ser una marca de tiempo con precisión de microsegundos dentro de la última hora o, si está habilitada la recuperación de un momento determinado, también puede ser una marca de tiempo de un minuto completo dentro de los últimos 7 días. Una marca de tiempo en formato RFC3339 UTC “Zulú”, con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de ListDocumentsResponse
.
Permisos de autorización
Se necesita uno de los siguientes alcances de OAuth:
https://www.googleapis.com/auth/datastore
https://www.googleapis.com/auth/cloud-platform
Para obtener más información, consulta Descripción general de la autenticación.