Method: scores.get

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

string

Identyfikator gracza. Zamiast identyfikatora uwierzytelnionego gracza można użyć wartości me.
leaderboardId

string

Identyfikator tabeli wyników. Można ustawić wartość „ALL”, aby pobrać dane wszystkich tabel wyników dla tej aplikacji.
timeSpan

enum (ScoreTimeSpan)

Przedział czasu dla wyników i pozycji, o które prosisz.

Parametry zapytania

Parametry
language

string

Preferowany język używany w przypadku ciągów tekstowych zwracanych przez tę metodę.
includeRankType

enum (IncludeRankType)

Typy rankingów do zwrócenia. W przypadku pominięcia tego parametru nie zostaną zwrócone żadne pozycje.
maxResults

integer

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 maxResults.
pageToken

string

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.