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 の概要をご覧ください。