Method: scores.get
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
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. |
El contenido y las muestras de código que aparecen en esta página están sujetas a las licencias que se describen en la Licencia de Contenido. Java y OpenJDK son marcas registradas de Oracle o sus afiliados.
Última actualización: 2025-07-27 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-07-27 (UTC)"],[],[],null,["# Method: scores.get\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [ScoreTimeSpan](#ScoreTimeSpan)\n- [IncludeRankType](#IncludeRankType)\n- [Try it!](#try-it)\n\nGet high scores, and optionally ranks, in leaderboards for the currently authenticated player. For a specific time span, `leaderboardId` can be set to `ALL` to retrieve data for all leaderboards in a given time span. \\`NOTE: You cannot ask for 'ALL' leaderboards and 'ALL' timeSpans in the same request; only one parameter may be set to 'ALL'.\n\n### HTTP request\n\n`GET https://games.googleapis.com/games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}`\n\n### Path parameters\n\n| Parameters ||\n|-----------------|------------------------------------------------------------------------------------------------------------------------------------------------|\n| `playerId` | `string` A player ID. A value of `me` may be used in place of the authenticated player's ID. |\n| `leaderboardId` | `string` The ID of the leaderboard. Can be set to 'ALL' to retrieve data for all leaderboards for this application. |\n| `timeSpan` | `enum (`[ScoreTimeSpan](/games/services/web/api/rest/v1/scores/get#ScoreTimeSpan)`)` The time span for the scores and ranks you're requesting. |\n\n### Query parameters\n\n| Parameters ||\n|-------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `language` | `string` The preferred language to use for strings returned by this method. |\n| `includeRankType` | `enum (`[IncludeRankType](/games/services/web/api/rest/v1/scores/get#IncludeRankType)`)` The types of ranks to return. If the parameter is omitted, no ranks will be returned. |\n| `maxResults` | `integer` The maximum number of leaderboard scores to return in the response. For any response, the actual number of leaderboard scores returned may be less than the specified `maxResults`. |\n| `pageToken` | `string` The token returned by the previous request. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [GetLeaderboardScoresResponse](/games/services/web/api/rest/v1/scores#GetLeaderboardScoresResponse).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/games`\n- `\n https://www.googleapis.com/auth/games_lite`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2).\n\nScoreTimeSpan\n-------------\n\nDefines possible time spans for a score.\n\n| Enums ||\n|------------|---------------------------------------------------------------------------------------------|\n| `ALL` | Get the high scores for all time spans. If this is used, maxResults values will be ignored. |\n| `ALL_TIME` | Get the all time high score. |\n| `WEEKLY` | List the top scores for the current day. |\n| `DAILY` | List the top scores for the current week. |\n\nIncludeRankType\n---------------\n\nPossible values for rank type.\n\n| Enums ||\n|-----------|---------------------------------------------------------------------------------------------|\n| `ALL` | Retrieve all supported ranks. In HTTP, this parameter value can also be specified as `ALL`. |\n| `PUBLIC` | Retrieve public ranks, if the player is sharing their gameplay activity publicly. |\n| `SOCIAL` | (Obsolete) Retrieve the social rank. | This item is deprecated! |\n| `FRIENDS` | Retrieve the rank on the friends collection. |"]]
