- HTTP-Anfrage
- Pfadparameter
- Anfrageparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- ScoreTimeSpan
- IncludeRankType
- Testen!
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 |
Eine Spieler-ID. Der Wert |
leaderboardId |
ID der Bestenliste Kann auf 'ALL' gesetzt werden, um Daten für alle Bestenlisten dieser Anwendung abzurufen. |
timeSpan |
Die Zeitspanne für die angeforderten Punktzahlen und Ränge. |
Abfrageparameter
Parameter | |
---|---|
language |
Die bevorzugte Sprache, die für Strings verwendet wird, die von dieser Methode zurückgegeben werden. |
includeRankType |
Die Rängetypen, die zurückgegeben werden sollen. Wenn der Parameter weggelassen wird, werden keine Ränge zurückgegeben. |
maxResults |
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 |
pageToken |
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. |