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