Method: achievements.list

現在認証されているプレーヤーの、アプリのすべての実績の進行状況を一覧表示します。

HTTP リクエスト

GET https://games.googleapis.com/games/v1/players/{playerId}/achievements

パスパラメータ

パラメータ
playerId

string

プレーヤー ID。認証済みのプレーヤーの ID の代わりに、me の値を使用できます。

クエリ パラメータ

パラメータ
language

string

このメソッドによって返される文字列に使用する優先言語。
maxResults

integer

レスポンスで返される実績リソースの最大数。ページングに使用されます。レスポンスごとに、返される実績リソースの数が指定された maxResults より少なくなる場合があります。
pageToken

string

前のリクエストで返されたトークン。
state

enum (State)

指定したステータスのアチーブメントのみを返すようサーバーに指示します。このパラメータが指定されていない場合は、すべての実績が返されます。

リクエストの本文

リクエストの本文は空にする必要があります。

レスポンスの本文

実績オブジェクトのリスト。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現 
{
  "kind": string,
  "nextPageToken": string,
  "items": [
    {
      object (PlayerAchievement)
    }
  ]
}
フィールド
kind

string

このリソースのタイプを一意に識別します。値は常に固定文字列 games#playerAchievementListResponse です。
nextPageToken

string

結果の次のページに対応するトークン。
items[]

object (PlayerAchievement)

実績。

認可スコープ

次のいずれかの OAuth スコープが必要です。

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

詳しくは、OAuth 2.0 の概要をご覧ください。

状態

列挙型
ALL すべての実績を一覧表示します。これがデフォルトです。
HIDDEN 非表示の実績のみを表示します。
REVEALED 公開されている実績のみを表示します。
UNLOCKED ロックを解除した実績のみを表示します。

PlayerAchievement

実績オブジェクト。

JSON 表現 
{
  "kind": string,
  "id": string,
  "currentSteps": integer,
  "formattedCurrentStepsString": string,
  "achievementState": enum (State),
  "lastUpdatedTimestamp": string,
  "experiencePoints": string
}
フィールド
kind

string

このリソースのタイプを一意に識別します。値は常に固定文字列 games#playerAchievement です。
id

string

実績の ID。
currentSteps

integer

段階的な達成の現在の手順。
formattedCurrentStepsString

string

増分実績の現在のステップ（文字列）。
achievementState

enum (State)

実績のステータス。
lastUpdatedTimestamp

string (int64 format)

この実績のステータスが最後に変更されたときのタイムスタンプ。
experiencePoints

string (int64 format)

実績で獲得した経験値。このフィールドは、まだロック解除されていない実績には表示されず、テスターによってロック解除されたが公開されていない実績には 0 と表示されます。

状態

実績の状態を定義します。

列挙型
HIDDEN 実績が非表示になっています。
REVEALED 実績が公開されます。
UNLOCKED 実績が解除された。