REST Resource: scores

資源：GetLeaderboardScoresResponse

玩家排行榜分數清單。

JSON 表示法 
{
  "kind": string,
  "nextPageToken": string,
  "player": {
    object (Player)
  },
  "items": [
    {
      object (LeaderboardScore)
    }
  ]
}
欄位
kind

string

專門用於識別這項資源的類型。值一律為固定字串 games#playerLeaderboardScoreListResponse。
nextPageToken

string

下一頁結果的分頁符記。
player

object (Player)

此分數擁有者的玩家資源。
items[]

object (LeaderboardScore)

排行榜分數。

LeaderboardScore

玩家排行榜分數物件。

JSON 表示法 
{
  "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
}
欄位
kind

string

專門用於識別這項資源的類型。值一律為固定字串 games#playerLeaderboardScore。
leaderboard_id

string

此分數的排行榜 ID。
scoreValue

string (int64 format)

此分數的數值。
scoreString

string

此分數的格式化值。
publicRank

object (LeaderboardScoreRank)

此排行榜中分數的公開排名。如果使用者未公開分享分數，系統就不會顯示這個物件。
socialRank

object (LeaderboardScoreRank)

此排行榜分數的社交排名。
friendsRank

object (LeaderboardScoreRank)

這個排行榜的好友集合中的分數排名。
timeSpan

enum (ScoreTimeSpan)

此分數的時間範圍。
writeTimestamp

string (int64 format)

記錄此分數的時間戳記，自 Epoch 紀元時間 (世界標準時間) 起算的毫秒數。
scoreTag

string

關於分數的其他資訊。如 RFC 3986 第 2.3 節所述，值最多只能包含 64 個 URI 安全字元。

LeaderboardScoreRank

排行榜中的分數排名。

JSON 表示法 
{
  "kind": string,
  "rank": string,
  "formattedRank": string,
  "numScores": string,
  "formattedNumScores": string
}
欄位
kind

string

專門用於識別這項資源的類型。值一律為固定字串 games#leaderboardScoreRank。
rank

string (int64 format)

排行榜中的排名。
formattedRank

string

排行榜中以字串表示的排名。
numScores

string (int64 format)

排行榜中的得分記錄數。
formattedNumScores

string

排行榜中以字串形式顯示的分數數量。

ScoreTimeSpan

定義分數的可能時間範圍。

列舉
ALL_TIME 分數是不限時間的分數。
WEEKLY 分數為每週分數。
DAILY 分數是每日分數。

方法

get

 為目前通過驗證的玩家在排行榜取得高分，並可選擇排名。

list

 從頂端開始列出排行榜分數。

listWindow

 列出玩家得分前後的排行榜分數。

submit

 提交分數至指定的排行榜。

submitMultiple

 將多個分數提交至排行榜。