승인 필요
지정된 애플리케이션에서 숨겨진 플레이어 목록을 가져옵니다. 이 방법은 개발자 콘솔의 사용자 계정에서만 사용할 수 있습니다.
요청
HTTP 요청
GET https://www.googleapis.com/games/v1management/applications/applicationId/players/hidden
매개변수
매개변수 이름 | 값 | 설명 |
---|---|---|
경로 매개변수 | ||
applicationId |
string |
Google Play Console의 애플리케이션 ID |
선택적 쿼리 매개변수 | ||
maxResults |
integer |
페이징에 사용되고 응답에서 반환할 플레이어 리소스의 최대 개수입니다. 어떤 응답이든 반환되는 플레이어 리소스의 실제 개수는 지정된 maxResults 보다 적을 수 있습니다.
사용 가능한 값: 1 ~15
|
pageToken |
string |
이전 요청에서 반환된 토큰입니다. |
승인
이 요청을 처리하려면 다음 범위의 승인이 필요합니다 (인증 및 승인 자세히 알아보기).
범위 |
---|
https://www.googleapis.com/auth/games |
요청 본문
이 메소드를 사용할 때는 요청 본문을 제공하지 마세요.
응답
요청에 성공할 경우 이 메소드는 다음과 같은 구조의 응답 본문을 반환합니다.
{ "kind": "gamesManagement#hiddenPlayerList", "nextPageToken": string, "items": [ { "kind": "gamesManagement#hiddenPlayer", "player": { "kind": "gamesManagement#player", "playerId": string, "displayName": string, "avatarImageUrl": string, "lastPlayedWith": { "timeMillis": long, "autoMatched": boolean }, "name": { "familyName": string, "givenName": string }, "experienceInfo": { "currentExperiencePoints": long, "lastLevelUpTimestampMillis": long, "currentLevel": { "level": integer, "minExperiencePoints": long, "maxExperiencePoints": long }, "nextLevel": { "level": integer, "minExperiencePoints": long, "maxExperiencePoints": long } }, "title": string }, "hiddenTimeMillis": long } ] }
속성 이름 | 값 | 설명 | 참고 |
---|---|---|---|
kind |
string |
이 리소스의 유형을 고유하게 식별합니다. 값은 항상 고정 문자열 gamesManagement#hiddenPlayerList 입니다. |
|
nextPageToken |
string |
다음 결과 페이지를 위한 페이지로 나누기 토큰입니다. | |
items[] |
list |
플레이어 | |
items[].kind |
string |
이 리소스의 유형을 고유하게 식별합니다. 값은 항상 고정 문자열 gamesManagement#hiddenPlayer 입니다. |
|
items[].player |
nested object |
플레이어 정보입니다. | |
items[].player.kind |
string |
이 리소스의 유형을 고유하게 식별합니다. 값은 항상 고정 문자열 gamesManagement#player 입니다. |
|
items[].player.playerId |
string |
플레이어의 ID입니다. | |
items[].player.displayName |
string |
플레이어에 표시할 이름입니다. | |
items[].player.avatarImageUrl |
string |
플레이어를 나타내는 이미지의 기본 URL입니다. | |
items[].player.lastPlayedWith |
nested object |
이 플레이어가 현재 인증된 플레이어로 멀티플레이어 게임을 마지막으로 플레이한 시간에 관한 세부정보입니다. PLAYED_WITH 플레이어 컬렉션 멤버에 대해 채워집니다. | |
items[].player.lastPlayedWith.timeMillis |
long |
에포크 이후 플레이어가 마지막으로 게임을 플레이한 시간(밀리초)(UTC)입니다. | |
items[].player.lastPlayedWith.autoMatched |
boolean |
플레이어가 현재 인증된 사용자와 자동 매칭된 경우 true입니다. | |
items[].player.name |
object |
플레이어 이름의 개별 구성요소를 나타내는 객체 표현입니다. 일부 플레이어의 경우 이러한 필드가 없을 수도 있습니다. | |
items[].player.name.familyName |
string |
이 플레이어의 성입니다. 일부 지역에서는 성이라고도 합니다. | |
items[].player.name.givenName |
string |
이 플레이어의 이름입니다. 일부 지역에서는 이름을 부르기도 합니다. | |
items[].player.experienceInfo |
nested object |
플레이어의 Play 게임즈 환경 정보를 나타내는 객체입니다. | |
items[].player.experienceInfo.currentExperiencePoints |
long |
플레이어의 현재 참여 점수입니다. | |
items[].player.experienceInfo.lastLevelUpTimestampMillis |
long |
플레이어의 레벨이 상승한 시점의 타임스탬프로, 유닉스 에포크 UTC 이후의 밀리초 단위입니다. | |
items[].player.experienceInfo.currentLevel |
nested object |
플레이어의 현재 레벨입니다. | |
items[].player.experienceInfo.currentLevel.level |
integer |
사용자의 수준입니다. | |
items[].player.experienceInfo.currentLevel.minExperiencePoints |
long |
이 레벨의 최소 참여 점수입니다. | |
items[].player.experienceInfo.currentLevel.maxExperiencePoints |
long |
이 레벨의 최대 참여 점수입니다. | |
items[].player.experienceInfo.nextLevel |
nested object |
플레이어의 다음 레벨입니다. 현재 등급이 최고 등급인 경우 현재 등급과 동일해야 합니다. | |
items[].player.experienceInfo.nextLevel.level |
integer |
사용자의 수준입니다. | |
items[].player.experienceInfo.nextLevel.minExperiencePoints |
long |
이 레벨의 최소 참여 점수입니다. | |
items[].player.experienceInfo.nextLevel.maxExperiencePoints |
long |
이 레벨의 최대 참여 점수입니다. | |
items[].player.title |
string |
게임 활동에 대한 보상을 받은 플레이어의 타이틀입니다. |