Achievements: list

現在認証されているプレーヤーのアプリケーションのすべての実績の進行状況を一覧表示します。 実習をご覧ください。

リクエスト

HTTP リクエスト

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

パラメータ

パラメータ名 説明
パスパラメータ
playerId string プレーヤー ID。認証済みプレーヤーの ID の代わりに値 me を使用できます。
省略可能なクエリ パラメータ
language string このメソッドから返される文字列に使用する言語。
maxResults integer レスポンスで返す実績リソースの最大数。ページ設定に使用されます。どのようなレスポンスでも、返される実績リソースの実際の数は、指定した maxResults より少ない場合があります。有効な値は 1200(指定した値を含む)です。
pageToken string 前のリクエストによって返されたトークン。
state string 指定した状態の実績のみを返すようにサーバーに指示します。このパラメータを指定しない場合、すべての実績が返されます。

有効な値は次のとおりです。
  • "ALL": すべての実績を一覧表示します。これがデフォルトです。
  • "HIDDEN": 非表示の実績のみを一覧表示します。
  • "REVEALED": 表示された実績のみを一覧表示します。
  • UNLOCKED: ロック解除された実績のみ。

承認

このリクエストには、次のスコープによる認証が必要です。

範囲
https://www.googleapis.com/auth/games

詳細については、認証と承認のページをご覧ください。

リクエスト本文

このメソッドをリクエストの本文に含めないでください。

レスポンス

成功すると、このメソッドは次の構造を含むレスポンスの本文を返します。

{
  "kind": "games#playerAchievementListResponse",
  "nextPageToken": string,
  "items": [
    {
      "kind": "games#playerAchievement",
      "id": string,
      "currentSteps": integer,
      "formattedCurrentStepsString": string,
      "achievementState": string,
      "lastUpdatedTimestamp": long,
      "experiencePoints": long
    }
  ]
}
プロパティ名 説明 備考
kind string このリソースの種類を一意に識別します。値は常に固定文字列の games#playerAchievementListResponse です。
nextPageToken string 結果の次のページに対応するトークン。
items[] list 実績。
items[].kind string このリソースの種類を一意に識別します。値は常に固定文字列の games#playerAchievement です。
items[].id string 実績の ID。
items[].currentSteps integer 増分実績の現在のステップ。
items[].formattedCurrentStepsString string 文字列としての増分実績の現在のステップ。
items[].achievementState string 実績の状態。
有効な値は次のとおりです。
  • HIDDEN」 - 実績が非表示になりました。
  • REVEALED」- 実績を表示します。
  • UNLOCKED」 - 実績のロックが解除されました。


有効な値は次のとおりです。
  • "HIDDEN"
  • REVEALED
  • UNLOCKED
items[].lastUpdatedTimestamp long この実績に最後に加えた変更のタイムスタンプ。
items[].experiencePoints long 実績によって獲得した経験値。このフィールドは、まだロック解除されていない実績の場合や、テスターによってロック解除された実績がまだ公開されていない実績の場合はありません。

実習

以下の API Explorer を使用して、ライブデータでこのメソッドを呼び出し、レスポンスを確認します。