REST Resource: scores

Ressource: GetLeaderboardScoresResponse

Eine Liste der Punktestände der Spieler in der Bestenliste.

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

string

Identifiziert eindeutig den Typ dieser Ressource. 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 Punktestände der Bestenliste.

LeaderboardScore

Ein Punktzahlobjekt in der 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

Identifiziert eindeutig den Typ dieser Ressource. 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 dieser Punktzahl.

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)

Rang der Punktzahl in der Freundessammlung für diese Bestenliste

timeSpan

enum (ScoreTimeSpan)

Die Zeitspanne dieses Scores.

writeTimestamp

string (int64 format)

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

scoreTag

string

Zusätzliche Informationen zur Bewertung. Die Werte dürfen nicht mehr als 64 URI-sichere Zeichen enthalten, wie in Abschnitt 2.3 von RFC 3986 definiert.

LeaderboardScoreRank

Ein Punkterang in einer Bestenliste.

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

string

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

rank

string (int64 format)

Rang in der Bestenliste

formattedRank

string

Rang in der Bestenliste als String.

numScores

string (int64 format)

Anzahl der Punktzahlen in der Bestenliste.

formattedNumScores

string

Die Anzahl der Punktzahlen in der Bestenliste als String.

ScoreTimeSpan

Definiert mögliche Zeitspannen für eine Punktzahl.

Enums
ALL_TIME Der Punktestand ist ein Rekordergebnis.
WEEKLY Der Wert ist ein wöchentlicher Wert.
DAILY Der Wert ist ein Tageswert.

Methoden

get

Highscores und optionale Ränge in Bestenlisten für den aktuell authentifizierten Spieler abrufen

list

Listet die Punktzahlen in einer Bestenliste auf, beginnend von oben.

listWindow

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

submit

Sendet eine Punktzahl an die angegebene Bestenliste.

submitMultiple

Sendet mehrere Punktzahlen an Bestenlisten.