Method: projects.databases.documents.get

Pobiera jeden dokument.

Żądanie HTTP

GET https://firestore.googleapis.com/v1beta1/{name=projects/*/databases/*/documents/*/**}

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
name	string Wymagane. Nazwa zasobu dokumentu do pobrania. W formacie: projects/{projectId}/databases/{databaseId}/documents/{document_path}.

Parametry zapytania

Parametry
mask	object (DocumentMask) Pola do zwrócenia. Jeśli zasada nie jest skonfigurowana, zwraca wszystkie pola. Jeśli dokument zawiera pole, którego nie ma w tej masce, nie zostanie ono zwrócone w odpowiedzi.
Parametr sumy consistency_selector. Tryb spójności tej transakcji. Jeśli nie jest skonfigurowana, domyślnie stosowana jest silna spójność. consistency_selector może mieć tylko jedną z tych wartości:
transaction	string (bytes format) Odczytywanie dokumentu w ramach transakcji. Ciąg zakodowany w formacie base64.
readTime	string (Timestamp format) Odczytuje wersję dokumentu w danym momencie. Musi to być sygnatura czasowa z dokładnością do mikrosekundy z ostatniej godziny. Jeśli odzyskiwanie do określonego momentu jest włączone, może to być dodatkowo pełna sygnatura czasowa z ostatnich 7 dni. Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

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

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