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 개요를 참고하세요.

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 업적이 잠금 해제되었습니다.