> ## 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 player-data get` | 플레이어 키의 일부 또는 전체를 읽습니다. |
| `playfab player-data set` | 키를 하나 이상 설정합니다. |
| `playfab player-data delete` | 키를 하나 이상 제거합니다. |

`player-data` 명령은 `--output table`을 허용하지 않습니다.

## 옵션

모든 `player-data` 명령은 다음 옵션을 사용합니다.

| 옵션 | 필수 | 설명 |
| - | - | - |
| `--playfab-id` | 예 | 플레이어의 PlayFab ID(마스터 플레이어 계정 ID)입니다. |
| `--visibility` | 아니요 | 데이터 계층: `client`(기본값), `read-only` 또는 `internal`. |
| `--publisher` | 아니요 | 플레이어의 타이틀 데이터 대신 퍼블리셔 데이터를 사용합니다. |

| 명령 | 옵션 |
| - | - |
| `player-data get` | 키 하나에는 `--key`, 쉼표로 구분된 키에는 `--keys`를 사용하며, 모든 키를 읽으려면 둘 다 생략합니다. `--value-only`를 `--key`와 함께 사용하면 값만 출력합니다. `--if-changed-from-version`은 버전이 다른 경우에만 데이터를 반환하며, `--value-only`와 함께 사용할 수 없습니다. |
| `player-data set` | `--key`와 `--value`를 사용하거나, 키와 값의 JSON 개체와 함께 `--data`를 사용합니다. 개체 및 배열 값은 JSON 문자열로 저장됩니다. `--permission`은 필수이지만 `--visibility internal`에서는 유효하지 않습니다. [권한](#permission)을 참조하세요. |
| `player-data delete` | 제거할 쉼표로 구분된 키인 `--keys`(필수). |

## PlayFab API 경로

`--visibility`와 `--publisher`가 API를 선택합니다.

| 범위 및 표시 유형 | `get` API | `set` 및 `delete` API |
| - | - | - |
| 타이틀, `client` | `/Admin/GetUserData` | `/Admin/UpdateUserData` |
| 타이틀, `read-only` | `/Admin/GetUserReadOnlyData` | `/Admin/UpdateUserReadOnlyData` |
| 타이틀, `internal` | `/Admin/GetUserInternalData` | `/Admin/UpdateUserInternalData` |
| 퍼블리셔, `client` | `/Admin/GetUserPublisherData` | `/Admin/UpdateUserPublisherData` |
| 퍼블리셔, `read-only` | `/Admin/GetUserPublisherReadOnlyData` | `/Admin/UpdateUserPublisherReadOnlyData` |
| 퍼블리셔, `internal` | `/Admin/GetUserPublisherInternalData` | `/Admin/UpdateUserPublisherInternalData` |

## 권한

`client` 또는 `read-only` 키는 플레이어만 읽을 수 있는 `Private`이거나 다른 플레이어도 읽을 수 있는
`Public`입니다. PlayFab은 `set`이 쓰는 모든 키에 전달한 권한을 부여하고 기존 권한을 대체하므로, 이러한
계층에서 `set`에는 `--permission`이 필요합니다. 권한은 `--data`의 모든 키에 적용됩니다. 키마다 다른 권한을
부여하려면 별도의 명령으로 설정하세요.

## 예제

플레이어의 `level` 키 값을 출력합니다.

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

다른 플레이어도 읽을 수 있도록 플레이어의 읽기 전용 데이터에 `level`을 설정합니다.

```bash theme={null}
xbox --playfab-title-id ABC123 playfab player-data set --playfab-id PLAYER123 --visibility read-only --key level --value 5 --permission Public
```

플레이어의 내부 데이터에 `rating`을 설정합니다.

```bash theme={null}
xbox --playfab-title-id ABC123 playfab player-data set --playfab-id PLAYER123 --visibility internal --key rating --value 1500
```

플레이어의 `level` 및 `legacyFlag` 키를 제거합니다.

```bash theme={null}
xbox --playfab-title-id ABC123 playfab player-data delete --playfab-id PLAYER123 --keys level,legacyFlag
```


## Related topics

- [플레이어 데이터](https://docs.xbox.com/ko/services/playfab/player-progression/player-data/index.md)
- [PlayFab 플레이어 진행도 문서](https://docs.xbox.com/ko/services/playfab/player-progression/index.md)
- [개요 - Winter Starfall](https://docs.xbox.com/ko/services/playfab/demo-game/overview.md)
- [플레이어 데이터 빠른 시작](https://docs.xbox.com/ko/services/playfab/player-progression/player-data/quickstart.md)
- [플레이어 데이터(목차)](https://docs.xbox.com/ko/services/xbox-services/player-data/live-playerdata-nav.md)
