Method: projects.databases.importDocuments

Importiert Dokumente in Google Cloud Firestore. Vorhandene Dokumente mit demselben Namen werden überschrieben. Der Import wird im Hintergrund ausgeführt und der Fortschritt kann über die erstellte Vorgangsressource überwacht und verwaltet werden. Wenn ein database.importDocuments-Vorgang abgebrochen wird, wurde möglicherweise bereits ein Teil der Daten in Cloud Firestore importiert.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Erforderlich. Datenbank, in die importiert werden soll. Muss das Format projects/{projectId}/databases/{databaseId} haben.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "collectionIds": [
    string
  ],
  "inputUriPrefix": string,
  "namespaceIds": [
    string
  ]
}
Felder
collectionIds[]

string

Die zu importierenden Sammlungs-IDs „Nicht angegeben“ bedeutet, dass alle im Import enthaltenen Sammlungen enthalten sind.
inputUriPrefix

string

Speicherort der exportierten Dateien. Sie muss mit dem „outputUriPräfix“ einer ExportDocumentsResponse aus einem erfolgreich abgeschlossenen Export übereinstimmen. Weitere Informationen: google.firestore.admin.v1.ExportDocumentsResponse.output_uri_prefix.
namespaceIds[]

string

Eine leere Liste stellt alle Namespaces dar. Dies ist die bevorzugte Verwendung für Datenbanken, die keine Namespaces verwenden.

Ein leeres Stringelement stellt den Standard-Namespace dar. Dies sollte verwendet werden, wenn die Datenbank Daten in nicht standardmäßigen Namespaces enthält, diese aber nicht einschließen möchte. Jeder Namespace in dieser Liste muss eindeutig sein.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Operation.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.