Method: scores.get

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.