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
    }
  ]
}

속성 이름	값	설명	Notes
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	플레이어의 레벨이 상승한 시점의 타임스탬프로 Unix 에포크 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	이 플레이어가 숨겨진 시간입니다.