このページは Cloud Translation API によって翻訳されました。

Achievements: list

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

リクエスト

HTTP リクエスト

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

パラメータ

パラメータ名	値	説明
パスパラメータ
`playerId`	`string`	プレーヤー ID。認証済みプレーヤーの ID の代わりに値 `me` を使用できます。
省略可能なクエリパラメータ
`language`	`string`	このメソッドから返される文字列に使用する言語。
`maxResults`	`integer`	レスポンスで返す実績リソースの最大数。ページ設定に使用されます。どのようなレスポンスでも、返される実績リソースの実際の数は、指定した `maxResults` より少ない場合があります。有効な値は `1`～`200`（指定した値を含む）です。
`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 を使用して、ライブデータでこのメソッドを呼び出し、レスポンスを確認します。