REST Resource: players

리소스: 플레이어

플레이어 리소스입니다.

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입니다. 이는 요청하는 플레이어의 player.get 호출에 대해서만, 플레이어 ID가 이후에 변경된 경우에만, 플레이어 ID 재매핑을 지원하는 클라이언트에 대해서만 채워집니다.
profileSettings

object (ProfileSettings)

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

object

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

string

이 플레이어의 성입니다. 일부 지역에서는 이를 성이라고 합니다.
name.givenName

string

이 플레이어의 이름입니다. 일부 지역에서는 이를 이름이라고 합니다.
experienceInfo

object (PlayerExperienceInfo)

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

string

게임 활동에 대한 리워드로 플레이어에게 주어진 칭호입니다.
friendStatus

enum (FriendStatus)

요청자와 관련된 특정 플레이어의 친구 상태입니다. 플레이어가 친구 목록을 게임과 공유하지 않는 경우 이 값은 설정되지 않습니다.
gamePlayerId

string

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

ProfileSettings

프로필 설정

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

string

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

boolean

현재 로그인한 플레이어에게 플레이어의 프로필이 표시되는지 여부입니다.
friendsListVisibility

enum (FriendsListVisibility)

FriendsListVisibility

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

Enum
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)

플레이어가 레벨을 올린 타임스탬프입니다(유닉스 에포크 UTC 이후 밀리초).
currentLevel

object (PlayerLevel)

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

object (PlayerLevel)

다음 단계의 플레이어입니다. 현재 수준이 최대 수준인 경우 이 값은 현재 수준과 동일해야 합니다.

PlayerLevel

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

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

string

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

integer

사용자의 등급입니다.
minExperiencePoints

string (int64 format)

이 등급의 최소 경험치입니다.
maxExperiencePoints

string (int64 format)

이 등급의 최대 경험치입니다.

FriendStatus

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

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

메서드

get

 지정된 ID의 플레이어 리소스를 가져옵니다.

getMultipleApplicationPlayerIds

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

getScopedPlayerIds

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

list

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