Method: scores.get

Obtén puntuaciones altas y, de manera opcional, clasificaciones en las tablas de clasificación del jugador autenticado actualmente. Para un período específico, leaderboardId se puede establecer en ALL para recuperar datos de todas las tablas de clasificación en un período determinado. "NOTA: No puedes solicitar "TODOS" los rankings y "TODOS" los períodos en la misma solicitud. Solo se puede establecer un parámetro como "TODOS".

Solicitud HTTP

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

Parámetros de ruta de acceso

Parámetros
playerId

string

Un ID de jugador. Se puede usar un valor de me en lugar del ID del jugador autenticado.
leaderboardId

string

El ID de la tabla de clasificación. Se puede establecer en "TODOS" para recuperar datos de todas las tablas de clasificación de esta aplicación.
timeSpan

enum (ScoreTimeSpan)

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

Parámetros de consulta

Parámetros
language

string

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

enum (IncludeRankType)

Los tipos de clasificaciones que se mostrarán. Si se omite el parámetro, no se mostrarán clasificaciones.
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.
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 GetLeaderboardScoresResponse.

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.

ScoreTimeSpan

Define los períodos posibles para una puntuación.

Enums
ALL Obtén las puntuaciones más altas de todos los períodos. Si se usa esta opción, se ignorarán los valores de maxResults.
ALL_TIME Obtén la puntuación más alta de todos los tiempos.
WEEKLY Muestra las puntuaciones más altas del día actual.
DAILY Muestra las puntuaciones más altas de la semana actual.

IncludeRankType

Valores posibles para el tipo de clasificación.

Enums
ALL Recupera todas las clasificaciones compatibles. En HTTP, este valor de parámetro también se puede especificar como ALL.
PUBLIC Recupera las clasificaciones públicas, si el jugador comparte su actividad de juego de forma pública.
SOCIAL

(Obsoleto) Recupera el ranking social.
FRIENDS Recupera la clasificación de la colección de amigos.