Method: projects.databases.importDocuments

Importiert Dokumente in Google Cloud Firestore. Vorhandene Dokumente mit demselben Namen werden überschrieben. Der Import erfolgt im Hintergrund und sein Fortschritt kann über die erstellte Operationsressource überwacht und verwaltet werden. Wenn ein „databases.importDocuments“-Vorgang abgebrochen wird, ist es möglich, dass eine Teilmenge der Daten bereits in Cloud Firestore importiert wurde.

HTTP-Anfrage

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

Die URL verwendet die gRPC-Transcoding -Syntax.

Pfadparameter

Parameter
name

string

Datenbank zum Importieren. Sollte die Form haben: projects/{projectId}/databases/{databaseId} .

Anforderungstext

Der Anfragetext enthält Daten mit folgender Struktur:

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

string

Welche Sammlungs-IDs importiert werden sollen. Nicht angegeben bedeutet, dass alle im Import enthaltenen Sammlungen enthalten sind.

inputUriPrefix

string

Speicherort der exportierten Dateien. Dies muss mit dem OutputUriPrefix einer ExportDocumentsResponse aus einem Export übereinstimmen, der erfolgreich abgeschlossen wurde. Siehe: google.firestore.admin.v1beta2.ExportDocumentsResponse.output_uri_prefix .

Antwortkörper

Bei Erfolg enthält der Antworttext eine Instanz von Operation .

Berechtigungsbereiche

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 .