Method: scores.get

Получите высокие баллы и, при необходимости, места в таблицах лидеров для текущего аутентифицированного игрока. Для определенного периода времени leaderboardId можно установить значение ALL , чтобы получить данные для всех таблиц лидеров за определенный период времени. `ПРИМЕЧАНИЕ. Вы не можете запросить «ВСЕ» списки лидеров и «ВСЕ» временные интервалы в одном запросе; только один параметр может быть установлен на «ВСЕ».

HTTP-запрос

GET https://games.googleapis.com/games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}

Параметры пути

Параметры
playerId

string

Идентификатор игрока. Вместо идентификатора аутентифицированного игрока можно использовать значение me .

leaderboardId

string

Идентификатор таблицы лидеров. Можно установить «ВСЕ», чтобы получить данные для всех таблиц лидеров для этого приложения.

timeSpan

enum ( ScoreTimeSpan )

Временной интервал для запрашиваемых вами оценок и рангов.

Параметры запроса

Параметры
language

string

Предпочтительный язык для строк, возвращаемых этим методом.

includeRankType

enum ( IncludeRankType )

Типы рангов, которые нужно вернуть. Если параметр опущен, ранги не возвращаются.

maxResults

integer

Максимальное количество результатов таблицы лидеров, возвращаемых в ответе. Для любого ответа фактическое количество возвращаемых результатов в таблице лидеров может быть меньше указанного maxResults .

pageToken

string

Токен, возвращенный предыдущим запросом.

Тело запроса

Тело запроса должно быть пустым.

Тело ответа

В случае успеха тело ответа содержит экземпляр GetLeaderboardScoresResponse .

Области авторизации

Требуется одна из следующих областей OAuth:

  • https://www.googleapis.com/auth/games
  • https://www.googleapis.com/auth/games_lite

Дополнительную информацию см. в обзоре OAuth 2.0 .

ОценкаTimeSpan

Определяет возможные временные интервалы для оценки.

Перечисления
ALL Получите высокие баллы за все промежутки времени. Если это используется, значения maxResults будут игнорироваться.
ALL_TIME Получите рекорд за все время.
WEEKLY Перечислите лучшие результаты за текущий день.
DAILY Перечислите лучшие результаты за текущую неделю.

Инклюдеранктипе

Возможные значения типа ранга.

Перечисления
ALL Получить все поддерживаемые ранги. В HTTP значение этого параметра также можно указать как ALL .
PUBLIC Получите публичные ранги, если игрок публично делится своей игровой деятельностью.
SOCIAL

(Устарело) Получить социальный ранг.

FRIENDS Получить рейтинг в коллекции друзей.