プレーヤーのスコアを中心として(そしてそのスコアを含む)リーダーボードにスコアをリストします。
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 の概要をご覧ください。