Method: achievements.updateMultiple

Обновляет несколько достижений для текущего аутентифицированного игрока.

HTTP-запрос

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

Тело запроса

Тело запроса содержит экземпляр UpdateMultipleAchievements .

Тело ответа

Ответное сообщение для достижений.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 .

ОбновлениеНесколько достижений

Список запросов на обновление достижений.

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 Достижение разблокировано.