Method: projects.databases.importDocuments

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 Operation que se crea. Si se cancela una operación databases.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

string

Obligatorio. Base de datos a la cual importar. Debe tener el formato projects/{projectId}/databases/{databaseId}.

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[]

string

Qué IDs de colección se importarán. Sin especificar se refiere a todas las colecciones incluidas en la importación.
inputUriPrefix

string

Ubicación de los archivos exportados. Debe coincidir con el outputUriPrefix de una ExportDocumentsResponse de una exportación que se completó correctamente. Consulta: google.firestore.admin.v1.ExportDocumentsResponse.output_uri_prefix.
namespaceIds[]

string

Una lista vacía representa todos los espacios de nombres. Este es el uso preferido para las bases de datos que no usan espacios de nombres.

Un elemento de cadena 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.

Alcances de autorización

Se necesita uno de los siguientes permisos 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.