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

有关得分的其他信息。值包含的 URI 安全字符不得超过 64 个（如 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

 向排行榜提交多个得分。