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 總覽。