Method: scores.listWindow

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

Solicitação HTTP

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

Parâmetros de caminho

Parâmetros
leaderboardId

string

O ID do placar.

collection

enum (ScoreCollection)

É a coleção de pontuações que você está solicitando.

Parâmetros de consulta

Parâmetros
language

string

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

timeSpan

enum (ScoreTimeSpan)

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

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.

resultsAbove

integer

O número preferido de pontuações para retornar acima da pontuação do jogador. Mais pontuações podem ser retornadas se o jogador estiver na parte inferior do quadro de liderança; menos podem ser retornadas se o jogador estiver no topo. Precisa ser menor ou igual a maxResults.

returnTopIfAbsent

boolean

Verdadeiro se as maiores pontuações devem ser retornadas quando o jogador não está no quadro de liderança. O padrão é verdadeiro (true).

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

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.