AchievementDefinitions: list

アプリの実績のすべての定義を一覧表示します。実習をご覧ください。

リクエスト

HTTP リクエスト

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

パラメータ

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

承認

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

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

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

リクエスト本文

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

レスポンス

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

{
  "kind": "games#achievementDefinitionsListResponse",
  "nextPageToken": string,
  "items": [
    {
      "kind": "games#achievementDefinition",
      "id": string,
      "name": string,
      "description": string,
      "achievementType": string,
      "totalSteps": integer,
      "formattedTotalSteps": string,
      "revealedIconUrl": string,
      "isRevealedIconUrlDefault": boolean,
      "unlockedIconUrl": string,
      "isUnlockedIconUrlDefault": boolean,
      "initialState": string,
      "experiencePoints": long
    }
  ]
}
プロパティ名 説明 備考
kind string このリソースの種類を一意に識別します。値は常に固定文字列の games#achievementDefinitionsListResponse です。
nextPageToken string 結果の次のページに対応するトークン。
items[] list 実績の定義。
items[].kind string このリソースの種類を一意に識別します。値は常に固定文字列の games#achievementDefinition です。
items[].id string 実績の ID。
items[].name string 実績の名前。
items[].description string 実績の説明。
items[].achievementType string 実績のタイプ。
有効な値は次のとおりです。
  • STANDARD」 - 実績はロックまたはロック解除されています。
  • INCREMENTAL」- 実績。増分。


有効な値は次のとおりです。
  • "INCREMENTAL"
  • STANDARD
items[].totalSteps integer 増分実績の合計歩数。
items[].formattedTotalSteps string 文字列として増分実績の合計ステップ。
items[].revealedIconUrl string 公開された実績アイコンの画像の URL。
items[].isRevealedIconUrlDefault boolean 表示されるアイコン アイコンがデフォルト画像か、ゲームで提供されたかを示します。
items[].unlockedIconUrl string 達成した実績アイコンの画像の URL。
items[].isUnlockedIconUrlDefault boolean 返されるロック解除されたアイコン画像がデフォルトの画像か、ゲームから提供されたか。
items[].initialState string 実績の初期状態。
有効な値は次のとおりです。
  • HIDDEN」 - 実績が非表示になりました。
  • REVEALED」- 実績を表示します。
  • UNLOCKED」 - 実績のロックが解除されました。


有効な値は次のとおりです。
  • "HIDDEN"
  • REVEALED
  • UNLOCKED
items[].experiencePoints long この実績のロックを解除すると獲得できる経験値。

実習

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