Method: projects.databases.importDocuments

Importuje dokumenty do Google Cloud Firestore. Istniejące dokumenty o takiej samej nazwie zostaną zastąpione. Import odbywa się w tle, a jego postęp można monitorować i zarządzać nim za pomocą tworzonego zasobu operacji. Jeśli operacja databases.importDocuments zostanie anulowana, możliwe, że podzbiór danych został już zaimportowany do Cloud Firestore.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
name

string

Baza danych, do której ma nastąpić import. Powinien mieć taki format: projects/{projectId}/databases/{databaseId}.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "collectionIds": [
    string
  ],
  "inputUriPrefix": string
}
Pola
collectionIds[]

string

Identyfikatory kolekcji do zaimportowania. Nieokreślone oznacza, że import obejmuje wszystkie kolekcje.
inputUriPrefix

string

Lokalizacja wyeksportowanych plików. Wartość musi być zgodna z wartościąoutputUriPrefix elementu ExportDocumentsResponse w eksporcie, który został ukończony. Zobacz: google.firestore.admin.v1beta2.ExportDocumentsResponse.output_uri_prefix.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu Operation.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie uwierzytelniania.