Method: scores.list

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

HTTP 请求

GET https://games.googleapis.com/games/v1/leaderboards/{leaderboardId}/scores/{collection}

路径参数

参数
leaderboardId

string

排行榜的 ID。

collection

enum (ScoreCollection)

您请求的得分集合。

查询参数

参数
language

string

此方法返回的字符串的首选语言。

timeSpan

enum (ScoreTimeSpan)

必需。您请求的得分和排名所涵盖的时间范围。

maxResults

integer

响应中可返回的排行榜得分数量上限。对于任何响应,返回的排行榜得分实际数量可能少于指定的 maxResults

pageToken

string

上一个请求返回的令牌。

请求正文

请求正文必须为空。

响应正文

如果成功,响应正文将包含一个 ListLeaderboardScoresResponse 实例。

授权范围

需要以下 OAuth 范围之一:

  • https://www.googleapis.com/auth/games
  • https://www.googleapis.com/auth/games_lite

如需了解详情,请参阅 OAuth 2.0 概览