Method: projects.databases.importDocuments

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

Solicitação HTTP

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

A URL usa sintaxe de transcodificação gRPC .

Parâmetros de caminho

Parâmetros
name

string

Obrigatório. Banco de dados para importar. Deve estar no formato: projects/{projectId}/databases/{databaseId} .

Solicitar corpo

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

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

string

Quais IDs de coleção importar. Não especificado significa todas as coleções incluídas na importação.

inputUriPrefix

string

Localização dos arquivos exportados. Deve corresponder ao outputUriPrefix de um ExportDocumentsResponse de uma exportação que foi concluída com êxito. Consulte: google.firestore.admin.v1.ExportDocumentsResponse.output_uri_prefix .

namespaceIds[]

string

Uma lista vazia representa todos os namespaces. Este é o uso preferencial para bancos de dados que não usam namespaces.

Um elemento de string vazio representa o namespace padrão. Deve ser usado se o banco de dados tiver dados em namespaces não padrão, mas não quiser incluí-los. Cada namespace nesta lista deve ser exclusivo.

Corpo de resposta

Se for bem-sucedido, o corpo da resposta conterá uma instância de Operation .

Escopos de autorização

Requer um dos seguintes escopos OAuth:

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

Para obter mais informações, consulte Visão geral da autenticação .