REST Resource: players

리소스: Player

플레이어 리소스.

JSON 표현 
{
  "kind": string,
  "playerId": string,
  "displayName": string,
  "avatarImageUrl": string,
  "bannerUrlPortrait": string,
  "bannerUrlLandscape": string,
  "originalPlayerId": string,
  "profileSettings": {
    object (ProfileSettings)
  },
  "name": {
    "familyName": string,
    "givenName": string
  },
  "experienceInfo": {
    object (PlayerExperienceInfo)
  },
  "title": string,
  "friendStatus": enum (FriendStatus),
  "gamePlayerId": string
}
필드
kind

string

이 리소스의 유형을 고유하게 식별합니다. 값은 항상 고정 문자열 games#player입니다.
playerId

string

플레이어의 ID입니다.
displayName

string

플레이어에 표시할 이름입니다.
avatarImageUrl

string

플레이어를 나타내는 이미지의 기본 URL입니다.
bannerUrlPortrait

string

세로 모드 플레이어 배너 이미지의 URL입니다.
bannerUrlLandscape

string

가로 모드 플레이어 배너 이미지의 URL입니다.
originalPlayerId

string

해당 플레이어가 게임에 처음 로그인할 때 사용된 플레이어 ID입니다. 플레이어 ID가 이후에 변경된 경우에만, 그리고 플레이어 ID 재매핑을 지원하는 클라이언트에 대해서만, 요청하는 플레이어의 player.get 호출에 관해서만 채워집니다.
profileSettings

object (ProfileSettings)

플레이어의 프로필 설정 플레이어의 프로필을 다른 플레이어에게 표시할지 여부를 제어합니다.
name

object

플레이어 이름의 개별 구성요소를 나타내는 객체 표현입니다. 일부 플레이어의 경우 이러한 필드가 표시되지 않을 수 있습니다.
name.familyName

string

이 플레이어의 성입니다. 어떤 곳에서는 성을 부르기도 합니다.
name.givenName

string

이 플레이어의 이름입니다. 어떤 곳에서는 이름으로도 알려져 있습니다.
experienceInfo

object (PlayerExperienceInfo)

플레이어의 Play 게임즈 환경 정보를 나타내는 객체입니다.
title

string

게임 활동에 대한 리워드를 받은 플레이어의 타이틀입니다.
friendStatus

enum (FriendStatus)

요청자를 기준으로 지정된 플레이어의 친구 상태입니다. 플레이어가 친구 목록을 게임과 공유하지 않으면 설정되지 않습니다.
gamePlayerId

string

애플리케이션별 고유 플레이어 식별자입니다.

프로필 설정

프로필 설정

JSON 표현 
{
  "kind": string,
  "profileVisible": boolean,
  "friendsListVisibility": enum (FriendsListVisibility)
}
필드
kind

string

이 리소스의 유형을 고유하게 식별합니다. 값은 항상 고정 문자열 games#profileSettings입니다.
profileVisible

boolean

플레이어의 프로필을 현재 로그인한 플레이어에게 공개할지 여부입니다.
friendsListVisibility

enum (FriendsListVisibility)

친구 목록 공개 상태

플레이어의 친구 목록을 게임에 표시할지 또는 요청할 수 있는지 여부입니다. 이 필드는 현재 로그인한 플레이어에 대해서만 채워집니다.

열거형
VISIBLE 친구 목록이 현재 게임에 표시됩니다.
REQUEST_REQUIRED 개발자가 친구 목록에 액세스할 수는 없지만 Android API를 호출하여 동의 대화상자를 표시할 수 있습니다.
UNAVAILABLE 이 사용자는 현재 친구 목록을 사용할 수 없으며, 사용자가 완전히 거부했거나 친구 기능을 사용할 수 없기 때문에 지금은 액세스 권한을 요청할 수 없습니다. 이 상태에서는 친구 목록에 대한 액세스를 요청할 수 없습니다.

PlayerExperienceInfo

플레이어 경험에 관한 퍼스트 파티/서드 파티 메타데이터입니다.

JSON 표현 
{
  "kind": string,
  "currentExperiencePoints": string,
  "lastLevelUpTimestampMillis": string,
  "currentLevel": {
    object (PlayerLevel)
  },
  "nextLevel": {
    object (PlayerLevel)
  }
}
필드
kind

string

이 리소스의 유형을 고유하게 식별합니다. 값은 항상 고정 문자열 games#playerExperienceInfo입니다.
currentExperiencePoints

string (int64 format)

플레이어의 현재 참여 점수입니다.
lastLevelUpTimestampMillis

string (int64 format)

플레이어의 레벨이 상승한 시점의 타임스탬프입니다(Unix 에포크 UTC 이후 밀리초 단위로 표시).
currentLevel

object (PlayerLevel)

플레이어의 현재 레벨입니다.
nextLevel

object (PlayerLevel)

플레이어의 다음 레벨입니다. 현재 등급이 최대 등급인 경우 현재 등급과 동일해야 합니다.

플레이어 레벨

사용자 등급에 관한 퍼스트 파티/서드 파티 메타데이터입니다.

JSON 표현 
{
  "kind": string,
  "level": integer,
  "minExperiencePoints": string,
  "maxExperiencePoints": string
}
필드
kind

string

이 리소스의 유형을 고유하게 식별합니다. 값은 항상 고정 문자열 games#playerLevel입니다.
level

integer

사용자의 등급입니다.
minExperiencePoints

string (int64 format)

이 레벨의 최소 참여 점수입니다.
maxExperiencePoints

string (int64 format)

이 레벨의 최대 참여 점수입니다.

친구 상태

플레이어 간의 우정 관계를 정의합니다.

열거형
NO_RELATIONSHIP 플레이어 간에는 관계가 없습니다.
FRIEND 플레이어와 요청자는 친구입니다.

방법

get

 지정된 ID가 있는 플레이어 리소스를 검색합니다.

getMultipleApplicationPlayerIds

 호출하는 애플리케이션과 동일한 개발자가 요청한 모든 게임에서 현재 인증된 플레이어의 애플리케이션 플레이어 ID를 가져옵니다.

getScopedPlayerIds

 현재 인증된 사용자의 범위가 지정된 플레이어 식별자를 검색합니다.

list

 현재 인증된 사용자의 플레이어 컬렉션을 가져옵니다.