Applications: listHidden

승인 필요

지정된 애플리케이션에서 숨겨진 플레이어 목록을 가져옵니다. 이 방법은 개발자 콘솔의 사용자 계정에서만 사용할 수 있습니다.

요청

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 게임 활동에 대한 보상을 받은 플레이어의 타이틀입니다.
items[].hiddenTimeMillis long 이 플레이어가 숨겨진 시간입니다.