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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
name

string

Wymagane. 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,
  "namespaceIds": [
    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.v1.ExportDocumentsResponse.output_uri_prefix.

namespaceIds[]

string

Pusta lista reprezentuje wszystkie przestrzenie nazw. Jest to preferowane rozwiązanie w przypadku baz danych, które nie korzystają z przestrzeni nazw.

Pusty element ciągu reprezentuje domyślną przestrzeń nazw. Należy go używać, jeśli baza danych ma dane w innych przestrzeniach nazw, ale nie chcesz ich uwzględniać. Każda przestrzeń nazw na tej liście musi być unikalna.

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).