> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 플레이어 계정

> PlayFab ID로 플레이어의 계정 정보를 조회합니다.

`playfab player` 명령 패밀리는 실험적 기능입니다. CLI 인터페이스는 피드백에 따라 변경되거나 제거될 수
있습니다.

플레이어의 계정 정보를 읽습니다.

| 명령 | PlayFab API 경로 | 설명 |
| - | - | - |
| `playfab player account get` | `/Admin/GetUserAccountInfo` | PlayFab ID로 플레이어의 계정을 가져옵니다. |

`player account get`에는 `--playfab-id`가 필요하며, `--output table`을 허용하지 않습니다.

```bash theme={null}
xbox --playfab-title-id ABC123 playfab player account get --playfab-id PLAYER123
```

## 전달할 ID

`--playfab-id`에는 PlayFab의 플레이어 로그인 API가 반환하는 PlayFab ID인 플레이어의 **마스터 플레이어 계정
ID**를 지정합니다.

PlayFab은 모든 플레이어에게 **타이틀 플레이어 계정 ID**도 부여합니다. 이 ID는 16자리 16진수 문자로 생김새가
같고 Game Manager에 둘 다 표시되지만, `GetUserAccountInfo`는 이 ID를 거부합니다.

```console theme={null}
$ xbox --playfab-title-id ABC123 playfab player account get --playfab-id TITLEPLAYER123
{"code":400,"status":"BadRequest","error":"AccountNotFound","errorCode":1001,"errorMessage":"User not found"}
```

존재하는 것으로 알고 있는 플레이어의 조회가 실패하면 마스터 플레이어 계정 ID를 전달했는지 확인하세요.

이 명령은 이메일, 사용자 이름, 표시 이름 또는 XBOX 사용자 ID 같은 플랫폼 ID로 플레이어를 조회할 수 없습니다.
먼저 Game Manager에서 플레이어를 찾아 PlayFab ID를 확인하세요.

## 반환되는 내용

응답은 연결된 모든 플랫폼 계정과, [`playfab file`](https://docs.xbox.com/ko/tools/xbox-cli/commands/playfab/file) 같은 다른 명령이
사용하는 타이틀 플레이어 계정 ID를 포함한 플레이어의 전체 계정 레코드입니다.

```bash theme={null}
xbox --playfab-title-id ABC123 --data-only playfab player account get --playfab-id PLAYER123
```

```json theme={null}
{
  "UserInfo": {
    "PlayFabId": "PLAYER123",
    "Created": "2026-08-27T16:03:09.477Z",
    "TitleInfo": {
      "Origination": "CustomId",
      "DisplayName": "Hero",
      "isBanned": false,
      "TitlePlayerAccount": { "Id": "TITLEPLAYER123", "Type": "title_player_account" }
    },
    "SteamInfo": { "SteamId": "76561197960287930", "SteamCountry": "US" },
    "PsnInfo": { "PsnAccountId": "1234567890", "PsnOnlineId": "player1" },
    "PrivateInfo": { "Email": "player@example.com" }
  }
}
```

레코드에는 플레이어의 이메일 주소 같은 개인 정보가 포함될 수 있습니다. PlayFab은 이를 로컬에 저장하지 않을
것을 권장하므로, 출력을 저장하거나 파이프할 위치에 주의하세요.


## Related topics

- [마스터 플레이어 계정 삭제](https://docs.xbox.com/ko/services/playfab/api-references/rest/admin/account-management/delete-master-player-account.md)
- [마스터 플레이어 계정 ID에서 타이틀 플레이어 가져오기](https://docs.xbox.com/ko/services/playfab/api-references/rest/profiles/account-management/get-title-players-from-master-player-account-ids.md)
- [플레이어 세부 정보 사용](https://docs.xbox.com/ko/services/playfab/player-progression/player-data/player-details.md)
- [플레이어 데이터](https://docs.xbox.com/ko/services/playfab/player-progression/player-data/index.md)
- [PlayFab GDPR - 플레이어 데이터 삭제](https://docs.xbox.com/ko/services/playfab/data-analytics/privacy-compliance/gdpr-deleting-player-data.md)
