- HTTP-запрос
- Параметры пути
- Параметры запроса
- Тело запроса
- Тело ответа
- Области авторизации
- ОценкаTimeSpan
- Инклюдеранктипе
- Попробуй это!
Получите высокие баллы и, при необходимости, места в таблицах лидеров для текущего аутентифицированного игрока. Для определенного периода времени leaderboardId
можно установить значение ALL
, чтобы получить данные для всех таблиц лидеров за определенный период времени. `ПРИМЕЧАНИЕ. Вы не можете запросить «ВСЕ» списки лидеров и «ВСЕ» временные интервалы в одном запросе; только один параметр может быть установлен на «ВСЕ».
HTTP-запрос
GET https://games.googleapis.com/games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}
Параметры пути
Параметры | |
---|---|
playerId | Идентификатор игрока. Вместо идентификатора аутентифицированного игрока можно использовать значение |
leaderboardId | Идентификатор таблицы лидеров. Можно установить «ВСЕ», чтобы получить данные для всех таблиц лидеров для этого приложения. |
timeSpan | Временной интервал для запрашиваемых вами оценок и рангов. |
Параметры запроса
Параметры | |
---|---|
language | Предпочтительный язык для строк, возвращаемых этим методом. |
includeRankType | Типы рангов, которые нужно вернуть. Если параметр опущен, ранги не возвращаются. |
maxResults | Максимальное количество результатов таблицы лидеров, возвращаемых в ответе. Для любого ответа фактическое количество возвращаемых результатов в таблице лидеров может быть меньше указанного |
pageToken | Токен, возвращенный предыдущим запросом. |
Тело запроса
Тело запроса должно быть пустым.
Тело ответа
В случае успеха тело ответа содержит экземпляр 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 | Получить рейтинг в коллекции друзей. |