Method: achievements.updateMultiple

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

HTTP リクエスト

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

リクエスト本文

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

レスポンスの本文

Achieves.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)

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

実績の更新

実績の更新リクエスト。

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 の更新がリクエストされた場合のペイロード。

実績の更新タイプ

実績の更新タイプの例。

列挙型
REVEAL 実績が表示されます。
UNLOCK 実績がロック解除されました。
INCREMENT 実績が上がる。
SET_STEPS_AT_LEAST 実績の進行状況が、少なくとも渡された値に設定されています。

実績の増分

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

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

string

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

integer

増加するステップ数。
requestId

string (int64 format)

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

実績の設定

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

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

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

達成状況の更新

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

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