Enumera documentos.
solicitud HTTP
GET https://firestore.googleapis.com/v1beta1/{parent=projects/*/databases/*/documents}/{collectionId}
La URL utiliza la sintaxis de transcodificación gRPC .
Parámetros de ruta
Parámetros | |
---|---|
parent | Requerido. El nombre del recurso principal. En el formato: Por ejemplo: |
collectionId | Opcional. El ID de la colección, relativo al Por ejemplo: Esto es opcional y, cuando no se proporciona, Firestore enumerará los documentos de todas las colecciones bajo el |
Parámetros de consulta
Parámetros | |
---|---|
pageSize | Opcional. El número máximo de documentos a devolver en una sola respuesta. Firestore puede devolver menos que este valor. |
pageToken | Opcional. Un token de página, recibido de una respuesta anterior Proporcione esto para recuperar la página siguiente. Al paginar, todos los demás parámetros (con excepción de |
orderBy | Opcional. La ordenación facultativa de los documentos a devolver. Por ejemplo: Esto refleja el |
mask | Opcional. Los campos a devolver. Si no se establece, devuelve todos los campos. Si un documento tiene un campo que no está presente en esta máscara, ese campo no se devolverá en la respuesta. |
showMissing | Si la lista muestra documentos faltantes. Falta un documento si no existe, pero hay subdocumentos anidados debajo de él. Cuando sea verdadero, dichos documentos faltantes se devolverán con una clave, pero no tendrán campos, Es posible que las solicitudes con |
Parámetro de unión consistency_selector . El modo de coherencia para esta transacción. Si no se establece, el valor predeterminado es una coherencia fuerte. consistency_selector puede ser sólo uno de los siguientes: | |
transaction | Realice la lectura como parte de una transacción ya activa. Una cadena codificada en base64. |
readTime | Realice la lectura a la hora indicada. Debe ser una marca de tiempo con precisión de microsegundos dentro de la última hora o, si la recuperación de un punto en el tiempo está habilitada, 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 "Zulu", 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 respuesta
Si tiene éxito, el cuerpo de la respuesta contiene una instancia de ListDocumentsResponse
.
Ámbitos de autorización
Requiere uno de los siguientes ámbitos de OAuth:
-
https://www.googleapis.com/auth/datastore
-
https://www.googleapis.com/auth/cloud-platform
Para obtener más información, consulte Descripción general de la autenticación .