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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

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
}
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.v1beta2.ExportDocumentsResponse.output_uri_prefix.

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.