Method: leaderboards.list
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Muestra una lista de todos los metadatos de la tabla de clasificación de tu aplicación.
Solicitud HTTP
GET https://games.googleapis.com/games/v1/leaderboards
Parámetros de consulta
| Parámetros |
language |
string
Es el idioma preferido para usar en las cadenas que muestra este método.
|
maxResults |
integer
Es la cantidad máxima de tablas de clasificación que se mostrarán en la respuesta. Para cualquier respuesta, la cantidad real 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
Una lista de objetos de tablas de clasificación.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
| Representación JSON |
{
"kind": string,
"nextPageToken": string,
"items": [
{
object (Leaderboard)
}
]
} |
| Campos |
kind |
string
Identifica de forma única el tipo de este recurso. El valor siempre es la cadena fija games#leaderboardListResponse.
|
nextPageToken |
string
Es el token que corresponde a la siguiente página de resultados.
|
items[] |
object (Leaderboard)
Las tablas de clasificación
|
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.
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: leaderboards.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListLeaderboardsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists all the leaderboard metadata for your application.\n\n### HTTP request\n\n`GET https://games.googleapis.com/games/v1/leaderboards`\n\n### Query parameters\n\n| Parameters ||\n|--------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `language` | `string` The preferred language to use for strings returned by this method. |\n| `maxResults` | `integer` The maximum number of leaderboards to return in the response. For any response, the actual number of leaderboards 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\nA list of leaderboard objects.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"nextPageToken\": string, \"items\": [ { object (/games/services/web/api/rest/v1/leaderboards#Leaderboard) } ] } ``` |\n\n| Fields ||\n|-----------------|---------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Uniquely identifies the type of this resource. Value is always the fixed string `games#leaderboardListResponse`. |\n| `nextPageToken` | `string` Token corresponding to the next page of results. |\n| `items[]` | `object (`[Leaderboard](/games/services/web/api/rest/v1/leaderboards#Leaderboard)`)` The leaderboards. |\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)."]]
