プレーヤーのスコアを中心に(およびそのスコアを含む)リーダーボードのスコアを一覧表示します。
HTTP リクエスト
GET https://games.googleapis.com/games/v1/leaderboards/{leaderboardId}/window/{collection}
パスパラメータ
パラメータ | |
---|---|
leaderboardId |
リーダーボードの ID。 |
collection |
リクエストするスコアのコレクション。 |
クエリ パラメータ
パラメータ | |
---|---|
language |
このメソッドによって返される文字列に使用する優先言語。 |
timeSpan |
必須。リクエストするスコアとランクの期間。 |
maxResults |
レスポンスで返されるリーダーボード スコアの最大数。レスポンスごとに、返されるリーダーボード スコアの実際の数は、指定された |
resultsAbove |
プレーヤーのスコアより上位のスコアを返す数。プレーヤーがリーダーボードの下位にいる場合は、より多くのスコアが返されることがあります。プレーヤーが上位にいる場合は、より少ないスコアが返されることがあります。maxResults 以下でなければなりません。 |
returnTopIfAbsent |
プレーヤーがリーダーボードにない場合に上位スコアを返す必要がある場合は true です。デフォルトは true です。 |
pageToken |
前のリクエストで返されたトークン。 |
リクエストの本文
リクエストの本文は空にする必要があります。
レスポンスの本文
成功した場合、レスポンスの本文には ListLeaderboardScoresResponse
のインスタンスが含まれます。
認可スコープ
次のいずれかの OAuth スコープが必要です。
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
詳しくは、OAuth 2.0 の概要をご覧ください。