Method: achievements.updateMultiple

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

HTTP リクエスト

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

リクエスト本文

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

レスポンスの本文

challengements.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

実績を設定する最小ステップ数。

UpdatedAchievement

更新された実績。

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 実績のロックが解除されました。