Method: achievements.updateMultiple

現在認証されているプレーヤーの複数の成果を更新します。

HTTP リクエスト

POST https://games.googleapis.com/games/v1/achievements/updateMultiple

リクエストの本文

リクエストの本文には UpdateMultipleAchievements のインスタンスが含まれます。

レスポンスの本文

achievements.updateMultiple rpc のレスポンス メッセージ。

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

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

string

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

object (UpdatedAchievement)

更新された実績のステータス。

認可スコープ

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

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

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

UpdateMultipleAchievements

実績の更新リクエストのリスト。

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

string

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

object (UpdateAchievement)

個々の実績の更新リクエスト。

UpdateAchievement

実績の更新リクエスト。

JSON 表現 
{
  "kind": string,
  "achievementId": string,
  "updateType": enum (AchievementUpdateType),
  "incrementPayload": {
    object (AchievementIncrement)
  },
  "setStepsAtLeastPayload": {
    object (SetAchievementSteps)
  }
}
フィールド
kind

string

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

string

この更新が適用される実績。
updateType

enum (AchievementUpdateType)

適用される更新のタイプ。
incrementPayload

object (AchievementIncrement)

アチーブメントに対して INCREMENT タイプの更新がリクエストされた場合のペイロード。
setStepsAtLeastPayload

object (SetAchievementSteps)

アチーブメントに対して SET_STEPS_AT_LEAST タイプの更新がリクエストされた場合のペイロード。

AchievementUpdateType

利用可能な実績の更新タイプ。

列挙型
REVEAL 実績が公開されます。
UNLOCK 実績が解除された。
INCREMENT 実績がインクリメントされます。
SET_STEPS_AT_LEAST 実績の進行状況は、渡された値以上に設定されます。

AchievementIncrement

実績の増加をリクエストするペイロード。

JSON 表現 
{
  "kind": string,
  "steps": integer,
  "requestId": string
}
フィールド
kind

string

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

integer

インクリメントするステップ数。
requestId

string (int64 format)

実績の増加に関連付けられた requestId。

SetAchievementSteps

実績の増加をリクエストするペイロード。

JSON 表現 
{
  "kind": string,
  "steps": integer
}
フィールド
kind

string

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

integer

実績を設定するために必要な歩数の最小値。

更新されたアチーブメント

更新された実績。

JSON 表現 
{
  "kind": string,
  "achievementId": string,
  "updateOccurred": boolean,
  "currentState": enum (UpdatedAchievementState),
  "currentSteps": integer,
  "newlyUnlocked": boolean
}
フィールド
kind

string

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

string

この更新が適用された実績。
updateOccurred

boolean

リクエストされた更新が実際に実績に影響したかどうか。
currentState

enum (UpdatedAchievementState)

実績の現在の状態。
currentSteps

integer

この実績に記録されている現在のステップ数（増分の場合）。
newlyUnlocked

boolean

この実績が新たにロック解除されたかどうか（つまり、この実績のロック解除リクエストがプレーヤーにとって初めてのものかどうか）。

UpdatedAchievementState

更新される可能性のある実績のステータス。

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