Method: scores.listWindow

Lista as pontuações em um placar em torno (e incluindo) a pontuação de um jogador.

Solicitação HTTP

GET https://games.googleapis.com/games/v1/leaderboards/{leaderboardId}/window/{collection}

Parâmetros de caminho

Parâmetros
leaderboardId

string

O ID da tabela de classificação.

collection

enum (ScoreCollection)

A coleção de pontuaçõ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.

timeSpan

enum (ScoreTimeSpan)

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

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.

resultsAbove

integer

O número preferido de pontuações a serem retornadas acima da pontuação do jogador. Mais pontuações podem ser retornadas se o jogador estiver na parte de baixo do placar. Menos pontuações podem ser retornadas se o jogador estiver na parte de cima. Precisa ser menor ou igual a maxResults.

returnTopIfAbsent

boolean

Verdadeiro se as melhores pontuações forem retornadas quando o jogador não estiver na tabela de classificação. O valor padrão é "true" (verdadeiro).

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 ListLeaderboardScoresResponse.

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.