REST Resource: scores

Ressource: GetLeaderboardScoresResponse

Eine Liste der Punktzahlen der Spieler in der Bestenliste.

JSON-Darstellung
{
  "kind": string,
  "nextPageToken": string,
  "player": {
    object (Player)
  },
  "items": [
    {
      object (LeaderboardScore)
    }
  ]
}
Felder
kind

string

Kennzeichnet den Typ dieser Ressource eindeutig. Der Wert ist immer der feste String games#playerLeaderboardScoreListResponse.

nextPageToken

string

Das Paginierungstoken für die nächste Ergebnisseite.

player

object (Player)

Die Spielerressourcen für den Eigentümer dieser Punktzahl.

items[]

object (LeaderboardScore)

Die Punktzahlen der Bestenliste.

LeaderboardScore

Ein Punktzahlobjekt für die Bestenliste.

JSON-Darstellung
{
  "kind": string,
  "leaderboard_id": string,
  "scoreValue": string,
  "scoreString": string,
  "publicRank": {
    object (LeaderboardScoreRank)
  },
  "socialRank": {
    object (LeaderboardScoreRank)
  },
  "friendsRank": {
    object (LeaderboardScoreRank)
  },
  "timeSpan": enum (ScoreTimeSpan),
  "writeTimestamp": string,
  "scoreTag": string
}
Felder
kind

string

Kennzeichnet den Typ dieser Ressource eindeutig. Der Wert ist immer der feste String games#playerLeaderboardScore.

leaderboard_id

string

ID der Bestenliste, in der sich diese Punktzahl befindet.

scoreValue

string (int64 format)

Der numerische Wert dieser Punktzahl.

scoreString

string

Der formatierte Wert dieses Werts.

publicRank

object (LeaderboardScoreRank)

Der öffentliche Rang der Punktzahl in dieser Bestenliste. Dieses Objekt ist nicht vorhanden, wenn der Nutzer seine Punktzahlen nicht öffentlich teilt.

socialRank

object (LeaderboardScoreRank)

Der soziale Rang der Punktzahl in dieser Bestenliste.

friendsRank

object (LeaderboardScoreRank)

Der Rang der Punktzahl in der Freundessammlung für diese Bestenliste.

timeSpan

enum (ScoreTimeSpan)

Die Zeitspanne dieser Bewertung.

writeTimestamp

string (int64 format)

Der Zeitstempel, zu dem dieser Wert aufgezeichnet wurde, in Millisekunden seit der Epoche in UTC.

scoreTag

string

Weitere Informationen zur Punktzahl. Werte dürfen nicht mehr als 64 URI-sichere Zeichen enthalten, wie in Abschnitt 2.3 von RFC 3986 definiert.

LeaderboardScoreRank

Ein Score-Rang in einer Bestenliste.

JSON-Darstellung
{
  "kind": string,
  "rank": string,
  "formattedRank": string,
  "numScores": string,
  "formattedNumScores": string
}
Felder
kind

string

Kennzeichnet den Typ dieser Ressource eindeutig. Der Wert ist immer der feste String games#leaderboardScoreRank.

rank

string (int64 format)

Der Rang in der Bestenliste.

formattedRank

string

Der Rang in der Bestenliste als String.

numScores

string (int64 format)

Die Anzahl der Punktzahlen in der Bestenliste.

formattedNumScores

string

Die Anzahl der Punktzahlen in der Bestenliste als String.

ScoreTimeSpan

Definiert mögliche Zeiträume für eine Bewertung.

Enums
ALL_TIME Der Punktestand ist eine Gesamtpunktzahl.
WEEKLY Die Punktzahl ist eine wöchentliche Punktzahl.
DAILY Der Index ist ein Tageswert.

Methoden

get

Sie können Highscores und optional auch Ränge in Bestenlisten des derzeit authentifizierten Spielers abrufen.

list

Listet die Punktzahlen in einer Bestenliste auf, beginnend mit dem obersten Punkt.

listWindow

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

submit

Sendet eine Punktzahl an die angegebene Bestenliste.

submitMultiple

Sendet mehrere Punktzahlen an Bestenlisten.