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/v1/{name=projects/*/databases/*}:importDocuments

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

Obbligatoria. 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,
  "namespaceIds": [
    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.v1.ExportDocumentsResponse.output_uri_prefix.
namespaceIds[]

string

Un elenco vuoto rappresenta tutti gli spazi dei nomi. Questo è l'utilizzo preferito per i database che non utilizzano spazi dei nomi.

Una stringa vuota rappresenta lo spazio dei nomi predefinito. Questa opzione deve essere utilizzata se il database contiene dati in spazi dei nomi non predefiniti, ma non vuole includerli. Ogni spazio dei nomi in questo elenco deve essere univoco.

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.