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 이 플레이어가 숨겨진 시간입니다.