Obtiene varios documentos.
No se garantiza que los documentos devueltos por este método se devuelvan en el mismo orden en que se solicitaron.
Solicitud HTTP
POST https://firestore.googleapis.com/v1beta1/{database=projects/*/databases/*}/documents:batchGet
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
database |
Obligatorio. Es el nombre de la base de datos. En el formato: |
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
Representación JSON |
---|
{ "documents": [ string ], "mask": { object ( |
Campos | |
---|---|
documents[] |
Los nombres de los documentos que se recuperarán. En el formato: |
mask |
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. |
Campo 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 |
Lee documentos de una transacción. String codificada en base64. |
newTransaction |
Inicia una nueva transacción y lee los documentos. La configuración predeterminada es una transacción de solo lectura. El nuevo ID de transacción se mostrará como la primera respuesta en la transmisión. |
readTime |
Lee los documentos tal como estaban 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 respuesta
La respuesta transmitida para Firestore.BatchGetDocuments
.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Representación JSON |
---|
{ "transaction": string, "readTime": string, // Union field |
Campos | |
---|---|
transaction |
Indica la transacción que se inició como parte de esta solicitud. Solo se establecerá en la primera respuesta y solo si se configuró String codificada en base64. |
readTime |
Es la hora a la que se leyó el documento. Esto puede aumentar monótonamente. En este caso, se garantiza que los documentos anteriores del flujo de resultados no han cambiado entre su readTime y este. Una marca de tiempo en formato RFC3339 UTC “Zulú”, con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
Campo de unión result . Un solo resultado. Puede estar vacío si el servidor solo muestra una transacción. Las direcciones (result ) solo pueden ser una de las siguientes opciones: |
|
found |
Un documento que se solicitó. |
missing |
Un nombre de documento que se solicitó, pero que no existe. En el formato: |
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.