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

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

ProfileSettings

프로필 설정

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

string

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

boolean

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

enum (FriendsListVisibility)

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)

플레이어의 다음 레벨입니다. 현재 레벨이 최대 레벨인 경우 이 레벨은 현재 레벨과 같아야 합니다.

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

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

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

방법

get

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

getMultipleApplicationPlayerIds

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

getScopedPlayerIds

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

list

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