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 Operação criado. Se uma operação databases.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 no qual 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

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