Method: scores.get
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Highscores und optionale Ränge in Bestenlisten für den aktuell authentifizierten Spieler abrufen Für eine bestimmte Zeitspanne kann leaderboardId auf ALL gesetzt werden, um Daten für alle Bestenlisten in einer bestimmten Zeitspanne abzurufen. `HINWEIS: Sie können nicht nach 'ALL' Bestenlisten und 'ALL' timeSpans in derselben Anfrage fragen; nur ein Parameter kann auf 'ALL' gesetzt werden.
HTTP-Anfrage
GET https://games.googleapis.com/games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}
Pfadparameter
| Parameter |
playerId |
string
Eine Spieler-ID. Der Wert me kann anstelle der ID des authentifizierten Spielers verwendet werden.
|
leaderboardId |
string
ID der Bestenliste Kann auf 'ALL' gesetzt werden, um Daten für alle Bestenlisten dieser Anwendung abzurufen.
|
timeSpan |
enum (ScoreTimeSpan)
Die Zeitspanne für die angeforderten Punktzahlen und Ränge.
|
Abfrageparameter
| Parameter |
language |
string
Die bevorzugte Sprache, die für Strings verwendet wird, die von dieser Methode zurückgegeben werden.
|
includeRankType |
enum (IncludeRankType)
Die Rängetypen, die zurückgegeben werden sollen. Wenn der Parameter weggelassen wird, werden keine Ränge zurückgegeben.
|
maxResults |
integer
Die maximale Anzahl von Bestenlisten-Punktzahlen, die in der Antwort zurückgegeben werden sollen. Bei jeder Antwort kann die tatsächliche Anzahl der zurückgegebenen Bestenlisten-Punktzahlen unter der angegebenen maxResults liegen.
|
pageToken |
string
Das von der vorherigen Anfrage zurückgegebene Token.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von GetLeaderboardScoresResponse.
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.
ScoreTimeSpan
Definiert mögliche Zeitspannen für eine Punktzahl.
| Enums |
ALL |
Highscores für alle Zeiträume abrufen In diesem Fall werden die Werte von maxResults ignoriert. |
ALL_TIME |
Hol dir den Highscore aller Zeiten. |
WEEKLY |
Listen Sie die höchsten Punktzahlen für den aktuellen Tag auf. |
DAILY |
Listen Sie die Höchstwerte für die aktuelle Woche auf. |
IncludeRankType
Mögliche Werte für den Rangtyp.
| Enums |
ALL |
Ruft alle unterstützten Ränge ab. In HTTP kann dieser Parameterwert auch als ALL angegeben werden. |
PUBLIC |
Öffentliche Ränge abrufen, wenn der Spieler seine Spielaktivitäten öffentlich teilt |
SOCIAL |
(Veraltet) Ruft den Rang in sozialen Netzwerken ab. |
FRIENDS |
Rufen Sie den Rang in der Freundessammlung ab. |
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: 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. |"]]
