- Solicitação HTTP
- Parâmetros de caminho
- Parâmetros de consulta
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- ScoreTimeSpan
- IncludeRankType
- Faça um teste
Obtenha as maiores pontuações e, opcionalmente, as classificações nos quadros de liderança do jogador autenticado no momento. Por um período específico, leaderboardId
pode ser definido como ALL
para recuperar dados de todos os placares em um determinado período. `OBSERVAÇÃO: não é possível solicitar 'TODOS' os placares e 'TODOS' os timeSpans na mesma solicitação. Apenas um parâmetro pode ser definido como 'ALL'.
Solicitação HTTP
GET https://games.googleapis.com/games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}
Parâmetros de caminho
Parâmetros | |
---|---|
playerId |
Um ID do jogador. Um valor de |
leaderboardId |
O ID do placar. Pode ser definido como "ALL" para recuperar dados de todos os placares desse aplicativo. |
timeSpan |
O período das pontuações e classificações solicitadas. |
Parâmetros de consulta
Parâmetros | |
---|---|
language |
O idioma preferido a ser usado para strings retornadas por este método. |
includeRankType |
Os tipos de classificações a serem retornadas. Se o parâmetro for omitido, nenhuma classificação será retornada. |
maxResults |
É o número máximo de pontuações do placar a serem retornadas na resposta. Para qualquer resposta, o número real de pontuações do placar retornadas pode ser menor do que o |
pageToken |
O token retornado pela solicitação anterior. |
Corpo da solicitação
O corpo da solicitação precisa estar vazio.
Corpo da resposta
Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de GetLeaderboardScoresResponse
.
Escopos de autorização
Requer um dos seguintes escopos de OAuth:
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
Para mais informações, consulte a Visão geral do OAuth 2.0.
ScoreTimeSpan
Define os possíveis períodos de uma pontuação.
Enums | |
---|---|
ALL |
Conseguir as maiores pontuações de todos os períodos. Se for usado, os valores maxResults serão ignorados. |
ALL_TIME |
Consiga a maior pontuação de todos os tempos. |
WEEKLY |
Lista as maiores pontuações do dia atual. |
DAILY |
Liste as maiores pontuações da semana atual. |
IncludeRankType
Valores possíveis para o tipo de classificação.
Enums | |
---|---|
ALL |
Recuperar todas as classificações compatíveis. Em HTTP, esse valor de parâmetro também pode ser especificado como ALL . |
PUBLIC |
Recuperar classificações públicas se o jogador estiver compartilhando a atividade de jogo publicamente. |
SOCIAL |
(Obsoleto) Recuperar a classificação social. |
FRIENDS |
Recuperar a classificação na coleção de amigos. |