Method: scores.get

• Solicitud HTTP
• Parámetros de ruta de acceso
• Parámetros de consulta
• Cuerpo de la solicitud
• Cuerpo de la respuesta
• Permisos de autorización
• ScoreTimeSpan
• IncludeRankType
• Pruébala

Obtener puntuaciones altas y, opcionalmente, clasificaciones en las tablas de clasificación del jugador autenticado actualmente Durante un período específico, se puede configurar leaderboardId como ALL para recuperar los datos de todas las tablas de clasificación en un período determinado. "NOTA: No puedes solicitar "TODOS" las tablas de clasificación y "TODOS" los intervalos de tiempo 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 los datos de todas las tablas de clasificación de esta aplicación.
timeSpan	enum (ScoreTimeSpan) El intervalo de tiempo de las puntuaciones y clasificaciones que solicitas.

Parámetros de consulta

Parámetros
language	string 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 La cantidad máxima de puntuaciones de la tabla de clasificación que se muestran en la respuesta. Para cualquier respuesta, la cantidad real de puntuaciones de la tabla de clasificación que se muestran puede ser menor que la maxResults especificada.
pageToken	string 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 contiene una instancia de GetLeaderboardScoresResponse.

Permisos de autorización

Se necesita uno de los siguientes alcances 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 intervalos de tiempo posibles para una puntuación.

Enumeradores
ALL	Obtener 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	Enumera las puntuaciones más altas del día actual.
DAILY	Enumera las puntuaciones más altas de la semana actual.

IncludeRankType

Valores posibles para el tipo de clasificación.

Enumeradores
ALL	Recupera todas las clasificaciones admitidas. En HTTP, este valor del parámetro también se puede especificar como ALL.
PUBLIC	Recuperar clasificaciones públicas si el jugador comparte públicamente su actividad del juego
SOCIAL	(Obsoleto) Recupera la clasificación social. Este elemento es obsoleto.
FRIENDS	Recupera la clasificación en la colección de amigos.