Method: achievementDefinitions.list

애플리케이션의 모든 업적 정의를 나열합니다.

HTTP 요청

GET https://games.googleapis.com/games/v1/achievements

쿼리 매개변수

매개변수
language

string

이 메서드에서 반환된 문자열에 사용할 기본 언어입니다.
maxResults

integer

응답에서 반환할 최대 업적 리소스 수입니다. 페이징에 사용됩니다. 응답의 경우 반환된 실제 업적 리소스 수가 지정된 maxResults보다 적을 수 있습니다.
pageToken

string

이전 요청에서 반환된 토큰입니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

업적 정의 객체 목록입니다.

성공하면 응답 본문에 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "kind": string,
  "nextPageToken": string,
  "items": [
    {
      object (AchievementDefinition)
    }
  ]
}
필드
kind

string

이 리소스의 유형을 고유하게 식별합니다. 값은 항상 고정 문자열 games#achievementDefinitionsListResponse입니다.
nextPageToken

string

결과의 다음 페이지에 해당하는 토큰입니다.
items[]

object (AchievementDefinition)

업적 정의

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/games
  • https://www.googleapis.com/auth/games_lite

자세한 내용은 OAuth 2.0 개요를 참고하세요.

AchievementDefinition

업적 정의 객체입니다.

JSON 표현 
{
  "kind": string,
  "id": string,
  "name": string,
  "description": string,
  "achievementType": enum (AchievementType),
  "totalSteps": integer,
  "formattedTotalSteps": string,
  "revealedIconUrl": string,
  "isRevealedIconUrlDefault": boolean,
  "unlockedIconUrl": string,
  "isUnlockedIconUrlDefault": boolean,
  "initialState": enum (InitialAchievementState),
  "experiencePoints": string
}
필드
kind

string

이 리소스의 유형을 고유하게 식별합니다. 값은 항상 고정 문자열 games#achievementDefinition입니다.
id

string

업적의 ID입니다.
name

string

업적의 이름입니다.
description

string

업적에 대한 설명입니다.
achievementType

enum (AchievementType)

업적 유형입니다.
totalSteps

integer

증분 업적의 총 걸음 수입니다.
formattedTotalSteps

string

문자열로 표시된 증분 업적의 총 걸음 수입니다.
revealedIconUrl

string

공개된 업적 아이콘의 이미지 URL입니다.
isRevealedIconUrlDefault

boolean

반환되는 공개된 아이콘 이미지가 기본 이미지인지 또는 게임에서 제공하는 이미지인지 나타냅니다.
unlockedIconUrl

string

잠금 해제된 업적 아이콘의 이미지 URL입니다.
isUnlockedIconUrlDefault

boolean

반환되는 잠금 해제된 아이콘 이미지가 기본 이미지인지 또는 게임에서 제공하는 이미지인지 나타냅니다.
initialState

enum (InitialAchievementState)

업적의 초기 상태입니다.
experiencePoints

string (int64 format)

이 업적을 잠금 해제할 때 얻게 되는 경험치입니다.

AchievementType

가능한 업적 유형입니다.

Enum
STANDARD 업적이 잠겨 있거나 잠금 해제되어 있습니다.
INCREMENTAL 업적은 점진적으로 쌓입니다.

InitialAchievementState

업적의 가능한 초기 상태입니다.

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