Importa documentos a Google Cloud Firestore. Se reemplazarán los documentos existentes con el mismo nombre. La importación se realiza en segundo plano, y su progreso se puede supervisar y administrar mediante el recurso de operación que se crea. Si se cancela una operación database.importDocuments, es posible que ya se haya importado un subconjunto de datos a Cloud Firestore.
Solicitud HTTP
POST https://firestore.googleapis.com/v1/{name=projects/*/databases/*}:importDocuments
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
name |
Obligatorio. Base de datos a la que se importará. Debe tener el formato |
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
Representación JSON |
---|
{ "collectionIds": [ string ], "inputUriPrefix": string, "namespaceIds": [ string ] } |
Campos | |
---|---|
collectionIds[] |
Los IDs de colecciones que se deben importar. Si no se especifica, se refiere a todas las colecciones incluidas en la importación. |
inputUriPrefix |
Ubicación de los archivos exportados Este debe coincidir con el outputUriPrefix de ExportDocumentsResponse de una exportación que se completó correctamente. Consulta: |
namespaceIds[] |
Una lista vacía representa todos los espacios de nombres. Este es el uso preferido para las bases de datos que no utilizan espacios de nombres. Un elemento de string vacía representa el espacio de nombres predeterminado. Se debe usar si la base de datos tiene datos en espacios de nombres no predeterminados, pero no desea incluirlos. Cada espacio de nombres de esta lista debe ser único. |
Cuerpo de la respuesta
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Operation
.
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.