- HTTP 요청
- 경로 매개변수
- 쿼리 매개변수
- 요청 본문
- 응답 본문
- 승인 범위
- 상태
- PlayerAchievement
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- 상태
- 실습
현재 인증된 플레이어의 모든 애플리케이션 업적 진행 상황을 나열합니다.
HTTP 요청
GET https://games.googleapis.com/games/v1/players/{playerId}/achievements
경로 매개변수
매개변수 | |
---|---|
playerId |
플레이어 ID입니다. 인증된 플레이어의 ID 대신 |
쿼리 매개변수
매개변수 | |
---|---|
language |
이 메서드가 반환하는 문자열에 사용할 기본 언어입니다. |
maxResults |
페이징에 사용되고 응답에서 반환할 업적 리소스의 최대 개수입니다. 어떤 응답이든 반환되는 업적 리소스의 실제 개수는 지정된 |
pageToken |
이전 요청에서 반환된 토큰입니다. |
state |
지정된 상태의 업적만 반환하도록 서버에 지시합니다. 이 매개변수를 지정하지 않으면 모든 업적이 반환됩니다. |
요청 본문
요청 본문은 비어 있어야 합니다.
응답 본문
업적 객체의 목록입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{
"kind": string,
"nextPageToken": string,
"items": [
{
object ( |
필드 | |
---|---|
kind |
이 리소스의 유형을 고유하게 식별합니다. 값은 항상 고정 문자열 |
nextPageToken |
결과의 다음 페이지에 해당하는 토큰입니다. |
items[] |
수료증입니다. |
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
자세한 내용은 OAuth 2.0 개요를 참고하세요.
주
열거형 | |
---|---|
ALL |
모든 업적을 나열합니다. 이는 기본값입니다. |
HIDDEN |
숨겨진 업적만 나열합니다. |
REVEALED |
공개된 업적만 나열합니다. |
UNLOCKED |
달성한 업적만 표시합니다. |
PlayerAchievement
업적 객체입니다.
JSON 표현 |
---|
{
"kind": string,
"id": string,
"currentSteps": integer,
"formattedCurrentStepsString": string,
"achievementState": enum ( |
필드 | |
---|---|
kind |
이 리소스의 유형을 고유하게 식별합니다. 값은 항상 고정 문자열 |
id |
업적의 ID입니다. |
currentSteps |
단계별 업적의 현재 단계입니다. |
formattedCurrentStepsString |
단계별 업적의 현재 단계입니다. |
achievementState |
업적의 상태입니다. |
lastUpdatedTimestamp |
이 업적 상태를 마지막으로 수정한 타임스탬프입니다. |
experiencePoints |
업적으로 획득한 참여 점수입니다. 아직 잠금 해제되지 않은 업적에는 이 필드가 표시되지 않고, 테스터가 달성했지만 게시되지 않은 업적에는 0이 표시됩니다. |
주
업적의 가능한 상태를 정의합니다.
열거형 | |
---|---|
HIDDEN |
업적이 숨겨졌습니다. |
REVEALED |
업적이 표시됩니다. |
UNLOCKED |
업적이 잠금 해제되었습니다. |