Method: projects.databases.importDocuments

Importiert Dokumente in den Google Cloud Firestore. Bestehende gleichnamige Dokumente werden überschrieben. Der Import erfolgt im Hintergrund und sein Fortschritt kann über die erstellte Operationsressource überwacht und verwaltet werden. Wenn ein Vorgang "database.importDocuments" abgebrochen wird, wurde möglicherweise bereits eine Teilmenge der Daten in den Cloud Firestore importiert.

HTTP-Anfrage

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

Die URL verwendet die gRPC-Transcodierungssyntax .

Pfadparameter

Parameter
name

string

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

Text anfordern

Der Anforderungshauptteil enthält Daten mit folgender Struktur:

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

string

Welche Sammlungs-IDs müssen importiert werden? Nicht spezifiziert bedeutet alle Sammlungen, die im Import 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.v1beta1.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 .