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że być monitorowany i można nim zarządzać za pomocą tworzonego zasobu operacji. Jeśli operacja databases.importDocuments została anulowana, podzbiór danych może 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 zostać zaimportowany. Powinien mieć 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. „Nie określono” oznacza, że wszystkie zbiory uwzględnione do importu.

inputUriPrefix

string

Lokalizacja wyeksportowanych plików. Musi być zgodny z outputUriPrefix odpowiedzi ExportDocumentsResponse z ukończonego pomyślnie eksportu. Zobacz: google.firestore.admin.v1beta2.ExportDocumentsResponse.output_uri_prefix.

Treść odpowiedzi

Jeśli operacja się uda, treść odpowiedzi będzie zawierała instancję Operation.

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu OAuth:

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

Więcej informacji znajdziesz w artykule o uwierzytelnianiu (w języku angielskim).