Method: projects.databases.importDocuments

Importa documentos para o Google Cloud Firestore. Os documentos existentes com o mesmo nome serão substituídos. A importação ocorre em segundo plano, e o progresso dela pode ser monitorado e gerenciado pelo recurso de operação criado. Se uma operação database.importDocuments for cancelada, é possível que um subconjunto dos dados já tenha sido importado para o Cloud Firestore.

Solicitação HTTP

POST https://firestore.googleapis.com/v1beta1/{name=projects/*/databases/*}:importDocuments

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
name

string

Banco de dados para onde importar. Precisa estar no formato: projects/{projectId}/databases/{databaseId}.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON
{
  "collectionIds": [
    string
  ],
  "inputUriPrefix": string
}
Campos
collectionIds[]

string

Os IDs de coleções a serem importados. Não especificado significa que todas as coleções incluídas na importação.

inputUriPrefix

string

Local dos arquivos exportados. Ele precisa corresponder ao outputUriPrefix de um ExportDocumentsResponse de uma exportação concluída. Consulte: google.firestore.admin.v1beta1.ExportDocumentsResponse.output_uri_prefix.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Operation.

Escopos de autorização

Requer um dos seguintes escopos de OAuth:

  • https://www.googleapis.com/auth/datastore
  • https://www.googleapis.com/auth/cloud-platform

Para saber mais, consulte a Visão geral da autenticação.