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

有关得分的更多信息。根据 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

 将多个得分提交到排行榜。