方法:scores.listWindow

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

HTTP 请求

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

路径参数

参数
leaderboardId

字符串

排行榜的 ID。

collection

枚举 (ScoreCollection)

您正在请求的分数集合。

查询参数

参数
language

字符串

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

timeSpan

枚举 (ScoreTimeSpan)

必填。您正在请求的分数和排名的时段。

maxResults

整数

要在响应中返回的排行榜分数的最大数量。对于任何响应,返回的排行榜分数的实际数量都可能小于指定的maxResults

resultsAbove

整数

要在玩家分数上方返回的首选分数数量。如果玩家位于排行榜底部,则可能会返回更多分数;如果玩家位于顶部,则可能会返回更少的分数。必须小于或等于 maxResults。

returnTopIfAbsent

布尔值

如果玩家不在排行榜中,则应返回最高分数。默认为 true。

pageToken

字符串

先前请求返回的令牌。

请求正文

请求正文必须为空。

响应正文

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

授权范围

需要以下 OAuth 范围之一

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

有关更多信息,请参阅OAuth 2.0 概述