Method: scores.listWindow

Listet die Punktzahlen in einer Bestenliste rund um die Punktzahl eines Spielers auf.

HTTP-Anfrage

GET https://games.googleapis.com/games/v1/leaderboards/{leaderboardId}/window/{collection}

Pfadparameter

Parameter
leaderboardId

string

ID der Bestenliste
collection

enum (ScoreCollection)

Die Sammlung der angeforderten Punktzahlen.

Abfrageparameter

Parameter
language

string

Die bevorzugte Sprache, die für Strings verwendet wird, die von dieser Methode zurückgegeben werden.
timeSpan

enum (ScoreTimeSpan)

Erforderlich. Die Zeitspanne für die angeforderten Punktzahlen und Ränge.
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.
resultsAbove

integer

Die bevorzugte Anzahl von Punktzahlen, die über der Punktzahl des Spielers zurückgegeben werden sollen. Wenn sich der Spieler ganz unten in der Bestenliste befindet, können mehr Punktzahlen zurückgegeben werden. Wenn sich der Spieler ganz oben befindet, können weniger Punkte zurückgegeben werden. Muss kleiner oder gleich „maxResults“ sein.
returnTopIfAbsent

boolean

„True“, wenn die besten Punktzahlen zurückgegeben werden sollen, wenn sich der Spieler nicht in der Bestenliste befindet. Der Standardwert ist „true“.
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 ListLeaderboardScoresResponse.

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.