REST 资源:scores

资源:GetLeaderboardScoresResponse

玩家排行榜分数列表。

JSON 表示形式
{
  "kind": string,
  "nextPageToken": string,
  "player": {
    object (Player)
  },
  "items": [
    {
      object (LeaderboardScore)
    }
  ]
}
字段
kind

字符串

唯一标识此资源的类型。值始终是固定字符串 games#playerLeaderboardScoreListResponse

nextPageToken

字符串

下一页结果的分页标记。

player

对象 (Player)

此分数所有者的 Player 资源。

items[]

对象 (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

字符串

唯一标识此资源的类型。值始终是固定字符串 games#playerLeaderboardScore

leaderboard_id

字符串

此分数所在的排行榜的 ID。

scoreValue

字符串 (int64 格式)

此分数的数值。

scoreString

字符串

此分数的格式化值。

publicRank

对象 (LeaderboardScoreRank)

此排行榜中分数的公开排名。如果用户未公开共享其分数,则此对象将不存在。

socialRank

对象 (LeaderboardScoreRank)

此排行榜中分数的社交排名。

friendsRank

对象 (LeaderboardScoreRank)

此排行榜的朋友收藏集中分数的排名。

timeSpan

枚举 (ScoreTimeSpan)

此分数的时间跨度。

writeTimestamp

字符串 (int64 格式)

记录此分数的时间戳,以毫秒为单位,自 UTC 纪元以来的时间。

scoreTag

字符串

有关分数的其他信息。值不得包含超过 64 个 RFC 3986 第 2.3 节中定义的 URI 安全字符。

LeaderboardScoreRank

排行榜中的分数排名。

JSON 表示形式
{
  "kind": string,
  "rank": string,
  "formattedRank": string,
  "numScores": string,
  "formattedNumScores": string
}
字段
kind

字符串

唯一标识此资源的类型。值始终是固定字符串 games#leaderboardScoreRank

rank

字符串 (int64 格式)

排行榜中的排名。

formattedRank

字符串

排行榜中的排名(以字符串形式表示)。

numScores

字符串 (int64 格式)

排行榜中的分数数量。

formattedNumScores

字符串

排行榜中的分数数量(以字符串形式表示)。

ScoreTimeSpan

定义分数可能的时间跨度。

枚举
ALL_TIME 分数是所有时间的分数。
WEEKLY 分数是每周的分数。
DAILY 分数是每日的分数。

方法

get

获取排行榜中当前已认证玩家的高分,以及可选的排名。

list

列出排行榜中的分数,从顶部开始。

listWindow

列出排行榜中围绕(包括)玩家分数的分数。

submit

将分数提交到指定的排行榜。

submitMultiple

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