Method: projects.databases.importDocuments

Importa i documenti in Google Cloud Firestore. I documenti esistenti con lo stesso nome vengono sovrascritti. L'importazione avviene in background e il suo avanzamento può essere monitorato e gestito tramite la risorsa Operazione creata. Se un'operazione database.importDocuments viene annullata, è possibile che un sottoinsieme di dati sia già stato importato in Cloud Firestore.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

Database in cui eseguire l'importazione. Deve essere nel formato: projects/{projectId}/databases/{databaseId}.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "collectionIds": [
    string
  ],
  "inputUriPrefix": string
}
Campi
collectionIds[]

string

Quali ID raccolta importare. Non specificati indica tutte le raccolte incluse nell'importazione.

inputUriPrefix

string

Percorso dei file esportati. Deve corrispondere al valore outputUriPrefix di un valore ExportDocumentsResponse di un'esportazione completata correttamente. Vedi: google.firestore.admin.v1beta2.ExportDocumentsResponse.output_uri_prefix.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.