Method: scores.listWindow

Muestra las puntuaciones en una tabla de clasificación alrededor de la puntuación de un jugador (incluida esta).

Solicitud HTTP

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

Parámetros de ruta de acceso

Parámetros
leaderboardId

string

El ID de la tabla de clasificación.

collection

enum (ScoreCollection)

Es la colección de puntuaciones que solicitas.

Parámetros de consulta

Parámetros
language

string

Es el idioma preferido para usar en las cadenas que muestra este método.

timeSpan

enum (ScoreTimeSpan)

Obligatorio. El período para las puntuaciones y clasificaciones que solicitas.

maxResults

integer

Es la cantidad máxima de puntuaciones de tablas de clasificación que se mostrarán en la respuesta. Para cualquier respuesta, la cantidad real de puntuaciones de tablas de clasificación que se muestra puede ser menor que el maxResults especificado.

resultsAbove

integer

Es la cantidad preferida de puntuaciones que se mostrarán por encima de la puntuación del jugador. Es posible que se muestren más puntuaciones si el jugador está en la parte inferior de la tabla de clasificación, o menos si está en la parte superior. Debe ser menor o igual que maxResults.

returnTopIfAbsent

boolean

Es verdadero si se deben mostrar las mejores puntuaciones cuando el jugador no está en la tabla de clasificación. El valor predeterminado es verdadero.

pageToken

string

Es el token que muestra la solicitud anterior.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contendrá una instancia de ListLeaderboardScoresResponse.

Permisos de autorización

Se requiere uno de los siguientes permisos de OAuth:

  • https://www.googleapis.com/auth/games
  • https://www.googleapis.com/auth/games_lite

Para obtener más información, consulta la descripción general de OAuth 2.0.