Method: scores.get

針對目前已驗證的玩家取得最高分，並視需要在排行榜中取得排名。將特定時間範圍內的 leaderboardId 設為 ALL，即可擷取指定時間範圍內所有排行榜的資料。`注意：您無法在同一個要求中要求「ALL」排行榜和「ALL」 timeSpans；只能將一個參數設為「ALL」。

HTTP 要求

GET https://games.googleapis.com/games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}

路徑參數

參數
playerId

string

玩家 ID。me 的值可用來取代已驗證玩家的 ID。
leaderboardId

string

排行榜 ID。可設為「ALL」，即可擷取這個應用程式的所有排行榜資料。
timeSpan

enum (ScoreTimeSpan)

要求分數的時間範圍及要求排名的時間範圍。

查詢參數

參數
language

string

此方法傳回的字串偏好語言。
includeRankType

enum (IncludeRankType)

要傳回的排名類型。如果省略這個參數，不會傳回排名。
maxResults

integer

回應中要傳回的排行榜分數上限。對任何回應而言，傳回的排行榜分數實際數量可能會低於指定的 maxResults。
pageToken

string

上一個要求傳回的權杖。

要求主體

要求主體必須為空白。

回應主體

如果成功，回應主體會包含 GetLeaderboardScoresResponse 的執行例項。

授權範圍

需要下列其中一種 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。

ScoreTimeSpan

定義分數的可能時間範圍。

列舉
ALL 取得所有時間範圍的高分。如果使用此值，系統將忽略 maxResults 值。
ALL_TIME 瞭解歷來最高分資訊。
WEEKLY 列出當天的最高分數。
DAILY 列出當週最高分數。

IncludeRankType

排名類型可能的值。

列舉
ALL 擷取所有支援的排名。在 HTTP 中，您也可以將這個參數值指定為 ALL。
PUBLIC 如果玩家公開分享遊戲活動，擷取公開排名。
SOCIAL

(已過時) 擷取社交排名。
FRIENDS 擷取好友集合中的排名。