Method: scores.listWindow

列出排行榜中与玩家得分相近（包括该得分）的得分。

HTTP 请求

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

路径参数

参数
leaderboardId

string

排行榜的 ID。
collection

enum (ScoreCollection)

您请求的得分集合。

查询参数

参数
language

string

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

enum (ScoreTimeSpan)

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

integer

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

integer

在玩家得分上方返回的首选得分数量。如果玩家位于排行榜底部，则系统可能会返回更多分数；如果玩家位于排行榜顶部，则系统可能会返回较少的分数。必须小于或等于 maxResults。
returnTopIfAbsent

boolean

如果玩家不在排行榜中，则应返回前几名分数，则为 true。默认值为 true。
pageToken

string

上一个请求返回的令牌。

请求正文

请求正文必须为空。

响应正文

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

授权范围

需要以下 OAuth 范围之一：

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

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