Method: scores.get

Receber pontuações altas e, opcionalmente, classificações nos placares do jogador autenticado. Para 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 pedir "TODOS" placares e "TODOS" períodos de tempo na mesma solicitação. Apenas um parâmetro pode ser definido como "TODOS".

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 da tabela de classificação. Pode ser definido como "ALL" para recuperar dados de todos os placares do app.
timeSpan

enum (ScoreTimeSpan)

O período de tempo das pontuações e classificações que você está solicitando.

Parâmetros de consulta

Parâmetros
language

string

O idioma preferencial a ser usado para strings retornadas por esse método.
includeRankType

enum (IncludeRankType)

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

integer

O número máximo de pontuações da tabela de classificação a serem retornadas na resposta. Para qualquer resposta, o número real de pontuações da tabela de classificação 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 concluída, o corpo da resposta terá uma instância de GetLeaderboardScoresResponse.

Escopos de autorização

Requer um dos seguintes escopos do 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.

Enumerações
ALL Receba as pontuações mais altas para todos os períodos. Se esse parâmetro for usado, os valores de maxResults serão ignorados.
ALL_TIME Conquiste a maior pontuação de todos os tempos.
WEEKLY Listar as melhores pontuações do dia atual.
DAILY Listar as melhores pontuações da semana atual.

IncludeRankType

Valores possíveis para o tipo de classificação.

Enumerações
ALL Extrair todas as classificações compatíveis. No HTTP, esse valor de parâmetro também pode ser especificado como ALL.
PUBLIC Extrair classificações públicas, se o jogador estiver compartilhando a atividade de jogo publicamente.
SOCIAL

(Descontinuado) Recupera a classificação social.
FRIENDS Extraia a classificação na coleção de amigos.