Method: scores.get

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

string

Um ID do jogador. Um valor de me pode ser usado no lugar do ID do jogador autenticado.
leaderboardId

string

O ID do placar. Pode ser definido como "ALL" para recuperar dados de todos os placares desse aplicativo.
timeSpan

enum (ScoreTimeSpan)

O período das pontuações e classificações solicitadas.

Parâmetros de consulta

Parâmetros
language

string

O idioma preferido a ser usado para strings retornadas por este método.
includeRankType

enum (IncludeRankType)

Os tipos de classificações a serem retornadas. Se o parâmetro for omitido, nenhuma classificação será retornada.
maxResults

integer

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

string

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.