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

가능한 업적 업데이트 유형입니다.

Enum
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

업데이트된 업적 상태는 다음과 같습니다.

Enum
HIDDEN 업적이 숨겨집니다.
REVEALED 업적이 표시됩니다.
UNLOCKED 업적이 잠금 해제됩니다.