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)

此得分记录的时间戳，以从公元纪年开始计算的毫秒数表示（世界协调时间 [UTC]）。
scoreTag

string

有关该得分的其他信息。值不得超过 64 个 URI 安全字符（如 RFC 3986 的第 2.3 节所定义）。

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

 向排行榜提交多个得分。