Method: projects.databases.importDocuments

Importa documentos a Google Cloud Firestore. Se sobrescriben los documentos existentes con el mismo nombre. La importación se produce en segundo plano y su progreso se puede monitorear y administrar a través del recurso Operación que se crea. Si se cancela una operación de bases de datos.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 utiliza la sintaxis de transcodificación gRPC .

Parámetros de ruta

Parámetros
name

string

Requerido. Base de datos para 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é ID de colección importar. Sin especificar significa todas las colecciones incluidas en la importación.

inputUriPrefix

string

Ubicación de los archivos exportados. Esto debe coincidir con el outputUriPrefix de una ExportDocumentsResponse de una exportación que se haya completado correctamente. Consulte: 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 bases de datos que no utilizan espacios de nombres.

Un elemento de cadena vacío representa el espacio de nombres predeterminado. Esto debe usarse si la base de datos tiene datos en espacios de nombres no predeterminados, pero no desea incluirlos. Cada espacio de nombres en esta lista debe ser único.

Cuerpo de respuesta

Si tiene éxito, el cuerpo de la respuesta contiene una instancia de Operation .

Á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 .