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/v1/{name=projects/*/databases/*}:importDocuments
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
name |
Wymagane. Baza danych, do której ma nastąpić import. Powinien mieć taki format: |
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "collectionIds": [ string ], "inputUriPrefix": string, "namespaceIds": [ string ] } |
Pola | |
---|---|
collectionIds[] |
Identyfikatory kolekcji do zaimportowania. Nieokreślone oznacza, że import obejmuje wszystkie kolekcje. |
inputUriPrefix |
Lokalizacja wyeksportowanych plików. Wartość musi być zgodna z wartościąoutputUriPrefix elementu ExportDocumentsResponse w eksporcie, który został ukończony. Zobacz: |
namespaceIds[] |
Pusta lista zawiera wszystkie przestrzenie nazw. Jest to preferowane użycie w przypadku baz danych, które nie korzystają z przestrzeni nazw. Pusty element ciągu to domyślna przestrzeń nazw. Należy go używać, jeśli baza danych zawiera dane w innych przestrzeniach nazw, ale nie chce ich uwzględniać. Każda przestrzeń nazw na tej liście musi być unikalna. |
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.