Method: leaderboards.list
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Listet alle Bestenlisten-Metadaten für Ihre Anwendung auf.
HTTP-Anfrage
GET https://games.googleapis.com/games/v1/leaderboards
Abfrageparameter
| Parameter |
language |
string
Die bevorzugte Sprache für Strings, die von dieser Methode zurückgegeben werden.
|
maxResults |
integer
Die maximale Anzahl von Bestenlisten, die in der Antwort zurückgegeben werden sollen. Bei jeder Antwort kann die tatsächliche Anzahl der zurückgegebenen Bestenlisten unter dem angegebenen maxResults liegen.
|
pageToken |
string
Das von der vorherigen Anfrage zurückgegebene Token.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Eine Liste mit Objekten der Bestenliste.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
| JSON-Darstellung |
{
"kind": string,
"nextPageToken": string,
"items": [
{
object (Leaderboard)
}
]
} |
| Felder |
kind |
string
Kennzeichnet den Typ dieser Ressource eindeutig. Der Wert ist immer der feste String games#leaderboardListResponse.
|
nextPageToken |
string
Token für die nächste Ergebnisseite.
|
items[] |
object (Leaderboard)
Die Bestenlisten.
|
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.
Alle Inhalte und Codebeispiele auf dieser Seite unterliegen den Lizenzen wie im Abschnitt Inhaltslizenz beschrieben. Java und OpenJDK sind Marken oder eingetragene Marken von Oracle und/oder seinen Tochtergesellschaften.
Zuletzt aktualisiert: 2025-07-27 (UTC).
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 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)."]]
