- Żądanie HTTP
- Parametry ścieżki
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- ScoreTimeSpan
- IncludeRankType
- Wypróbuj
Otrzymuj najlepsze wyniki i opcjonalnie pozycję w tabeli wyników dla aktualnie uwierzytelnionego gracza. W określonym przedziale czasu ustawienie leaderboardId
może mieć wartość ALL
, aby umożliwić pobieranie danych ze wszystkich tabel wyników w danym przedziale czasu. `UWAGA: w tym samym żądaniu nie można prosić o tabele wyników dla WSZYSTKICH ani WSZYSTKIE przedziały czasowe. Tylko jeden parametr może mieć wartość „ALL”.
Żądanie HTTP
GET https://games.googleapis.com/games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}
Parametry ścieżki
Parametry | |
---|---|
playerId |
Identyfikator gracza. Zamiast identyfikatora uwierzytelnionego gracza można użyć wartości |
leaderboardId |
Identyfikator tabeli wyników. Można ustawić wartość „ALL”, aby pobrać dane wszystkich tabel wyników dla tej aplikacji. |
timeSpan |
Przedział czasu dla wyników i pozycji, o które prosisz. |
Parametry zapytania
Parametry | |
---|---|
language |
Preferowany język używany w przypadku ciągów tekstowych zwracanych przez tę metodę. |
includeRankType |
Typy rankingów do zwrócenia. W przypadku pominięcia tego parametru nie zostaną zwrócone żadne pozycje. |
maxResults |
Maksymalna liczba wyników w tabeli wyników zwracanych w odpowiedzi. W przypadku każdej odpowiedzi rzeczywista liczba zwróconych wyników w tabeli może być mniejsza od podanej wartości |
pageToken |
Token zwrócony przez poprzednie żądanie. |
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu GetLeaderboardScoresResponse
.
Zakresy autoryzacji
Wymaga jednego z tych zakresów OAuth:
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.
ScoreTimeSpan
Określa możliwe przedziały czasu dla wyniku.
Wartości w polu enum | |
---|---|
ALL |
Uzyskaj najlepsze wyniki we wszystkich okresach. Jeśli ta opcja jest używana, wartości maxResults są ignorowane. |
ALL_TIME |
Uzbieraj rekord w historii. |
WEEKLY |
Utwórz listę najlepszych wyników z bieżącego dnia. |
DAILY |
Lista najlepszych wyników w bieżącym tygodniu. |
IncludeRankType
Możliwe wartości typu rankingu.
Wartości w polu enum | |
---|---|
ALL |
Pobierz wszystkie obsługiwane pozycje. W HTTP ta wartość parametru może być też określona jako ALL . |
PUBLIC |
Odzyskaj publiczne miejsce w rankingu, jeśli gracz udostępnia publicznie swoją aktywność w grach. |
SOCIAL |
(Nieaktualne) Pobierz pozycję społeczną. |
FRIENDS |
Pobierz pozycję w kolekcji znajomych. |