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/v1/{name=projects/*/databases/*}:importDocuments
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
Parâmetros | |
---|---|
name |
Obrigatório. Banco de dados no qual importar. Precisa estar no formato: |
Corpo da solicitação
O corpo da solicitação contém dados com a seguinte estrutura:
Representação JSON |
---|
{ "collectionIds": [ string ], "inputUriPrefix": string, "namespaceIds": [ string ] } |
Campos | |
---|---|
collectionIds[] |
IDs de coleções a serem importados. "Não especificado" significa que todas as coleções incluídas na importação. |
inputUriPrefix |
Local dos arquivos exportados. Precisa corresponder ao outputUriPrefix de um ExportDocumentsResponse de uma exportação concluída. Consulte: |
namespaceIds[] |
Uma lista vazia representa todos os namespaces. Esse é o uso preferencial para bancos de dados que não usam namespaces. Um elemento de string vazio representa o namespace padrão. Use se o banco de dados tiver dados em namespaces não padrão, mas você não quiser incluí-los. Cada namespace dessa lista precisa ser exclusivo. |
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.