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

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