アプリの実績のすべての定義を一覧表示します。実習をご覧ください。
リクエスト
HTTP リクエスト
GET https://www.googleapis.com/games/v1/achievements
パラメータ
パラメータ名 | 値 | 説明 |
---|---|---|
省略可能なクエリ パラメータ | ||
language |
string |
このメソッドから返される文字列に使用する言語。 |
maxResults |
integer |
レスポンスで返す実績リソースの最大数。ページ設定に使用されます。どのようなレスポンスでも、返される実績リソースの実際の数は、指定した maxResults より少ない場合があります。有効な値は 1 ~200 (指定した値を含む)です。
|
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 |
実績のタイプ。 有効な値は次のとおりです。
有効な値は次のとおりです。
|
|
items[].totalSteps |
integer |
増分実績の合計歩数。 | |
items[].formattedTotalSteps |
string |
文字列として増分実績の合計ステップ。 | |
items[].revealedIconUrl |
string |
公開された実績アイコンの画像の URL。 | |
items[].isRevealedIconUrlDefault |
boolean |
表示されるアイコン アイコンがデフォルト画像か、ゲームで提供されたかを示します。 | |
items[].unlockedIconUrl |
string |
達成した実績アイコンの画像の URL。 | |
items[].isUnlockedIconUrlDefault |
boolean |
返されるロック解除されたアイコン画像がデフォルトの画像か、ゲームから提供されたか。 | |
items[].initialState |
string |
実績の初期状態。 有効な値は次のとおりです。
有効な値は次のとおりです。
|
|
items[].experiencePoints |
long |
この実績のロックを解除すると獲得できる経験値。 |
実習
以下の API Explorer を使用して、ライブデータでこのメソッドを呼び出し、レスポンスを確認します。