Method: achievements.updateMultiple

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

HTTP リクエスト

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

リクエスト本文

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

レスポンスの本文

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