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