Scores: get

Receba pontuações altas e, como opção, classificações nos placares do jogador autenticado no momento. Para um período específico, o 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 "ALL" placares e "ALL" timeSpans na mesma solicitação. Apenas um parâmetro pode ser definido como "ALL". Faça um teste.

Solicitação

Solicitação HTTP

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

Parâmetros

Nome do parâmetro Valor Descrição
Parâmetros de caminho
leaderboardId string É o ID do placar. Pode ser definido como "ALL" para recuperar os dados de todos os placares deste app.
playerId string Um ID do jogador. Um valor de me pode ser usado no lugar do ID do player autenticado.
timeSpan string O período para as pontuações e classificações solicitadas.

Os valores aceitáveis são:
  • "ALL": receba as maiores pontuações de todos os períodos. Se usado, os valores de maxResults serão ignorados.
  • "ALL_TIME": tenha a maior pontuação de todos os tempos.
  • "DAILY": exibe as pontuações mais altas do dia atual.
  • "WEEKLY": liste as pontuações mais altas da semana atual.
Parâmetros de consulta opcionais
includeRankType string Os tipos de classificação a serem retornados. Se o parâmetro for omitido, nenhuma classificação será retornada.

Os valores aceitáveis são:
  • "ALL": recupere todas as classificações compatíveis.
  • "FRIENDS": recupera a classificação na coleção de amigos.
  • "PUBLIC": extraia classificações públicas se o jogador estiver compartilhando a atividade do jogo publicamente.
  • "SOCIAL": (obsoleto) classificação de placares sociais do G+ legados, sempre 1.
language string O idioma preferencial a ser usado para strings retornadas por esse método.
maxResults integer O número máximo de pontuações de placar a serem retornadas na resposta. Para qualquer resposta, o número real de pontuações de placar retornadas pode ser menor que o maxResults especificado. Os valores aceitos são de 1 a 30, inclusive.
pageToken string O token retornado pela solicitação anterior.

Autorização

Esta solicitação requer autorização com o seguinte escopo:

Escopo
https://www.googleapis.com/auth/games

Para mais informações, consulte a página de autenticação e autorização.

Corpo da solicitação

Não forneça um corpo de solicitação com este método.

Resposta

Se for bem-sucedido, este método retornará um recurso Scores no corpo da resposta.

Confira!

Use o APIs Explorer abaixo para chamar esse método em dados ativos e ver a resposta.