Method: achievements.list

현재 인증된 플레이어의 모든 애플리케이션 업적 진행 상황을 나열합니다.

HTTP 요청

GET https://games.googleapis.com/games/v1/players/{playerId}/achievements

경로 매개변수

매개변수
playerId

string

플레이어 ID입니다. 인증된 플레이어의 ID 대신 me 값을 사용할 수 있습니다.

쿼리 매개변수

매개변수
language

string

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

integer

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

string

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

enum (State)

서버에 지정된 상태의 업적만 반환하도록 지시합니다. 이 매개변수를 지정하지 않으면 모든 업적이 반환됩니다.

요청 본문

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

응답 본문

업적 객체 목록입니다.

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

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

string

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

string

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

object (PlayerAchievement)

업적

승인 범위

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

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

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

상태

Enum
ALL 모든 업적을 나열합니다. 이는 기본값입니다.
HIDDEN 숨겨진 업적만 표시합니다.
REVEALED 공개된 업적만 목록에 표시되었습니다.
UNLOCKED 달성한 업적만 표시합니다.

PlayerAchievement

업적 객체입니다.

JSON 표현 
{
  "kind": string,
  "id": string,
  "currentSteps": integer,
  "formattedCurrentStepsString": string,
  "achievementState": enum (State),
  "lastUpdatedTimestamp": string,
  "experiencePoints": string
}
필드
kind

string

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

string

업적의 ID입니다.
currentSteps

integer

점진적 업적 달성을 위한 현재 단계입니다.
formattedCurrentStepsString

string

증분 업적의 현재 단계를 문자열로 나타냅니다.
achievementState

enum (State)

업적의 상태입니다.
lastUpdatedTimestamp

string (int64 format)

이 업적의 상태가 마지막으로 수정된 타임스탬프입니다.
experiencePoints

string (int64 format)

업적 달성으로 획득한 참여 점수입니다. 아직 잠금 해제되지 않은 업적에는 이 필드가 없으며 테스터가 잠금 해제했지만 게시되지 않은 업적에는 0이 표시됩니다.

상태

업적의 가능한 상태를 정의합니다.

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