> ## 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.

# 타이틀 데이터

> 클라이언트에서 읽을 수 있거나 내부용인 타이틀 전체 키/값 데이터를 읽고, 설정하고, 삭제합니다.

타이틀 전체 키/값 데이터를 관리합니다. 명령은 플레이어의 게임 클라이언트가 읽는 클라이언트 읽기 가능 타이틀
데이터를 대상으로 하며, `--internal`을 추가하면 서버 전용 내부 타이틀 데이터를 대상으로 합니다. 타이틀에 대한
**Admin** 권한이 필요합니다.
[PlayFab 인증 작동 방식](https://docs.xbox.com/ko/tools/xbox-cli/authentication.md#how-playfab-authentication-works)을 참조하세요.

| 명령 | PlayFab API 경로 | 설명 |
| - | - | - |
| `playfab title-data get` | `/Admin/GetTitleData` 또는 `/Admin/GetTitleInternalData` | 키 하나, 여러 키 또는 모든 키를 읽습니다. |
| `playfab title-data set` | `/Admin/SetTitleData` 또는 `/Admin/SetTitleInternalData` | 키를 하나 이상 설정합니다. |
| `playfab title-data delete` | `null` 값을 사용하는 `/Admin/SetTitleData` 또는 `/Admin/SetTitleInternalData` | 키를 하나 이상 제거합니다. |

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

## `playfab title-data get`

```text theme={null}
xbox --playfab-title-id ABC123 playfab title-data get [key] [flags]
```

| 인수 / 옵션 | 설명 |
| - | - |
| `[key]` | 읽을 키 하나입니다. `--key`와 같으며, 둘 중 하나만 전달하세요. 빈 키는 모든 키로 읽히지 않고 거부됩니다. |
| `--key <key>` | 읽을 키 하나입니다. |
| `--keys <a,b,c>` | 읽을 쉼표로 구분된 키입니다. 단일 키와 함께 사용할 수 없습니다. |
| `--internal` | 클라이언트 읽기 가능 타이틀 데이터 대신 내부 타이틀 데이터를 읽습니다. |

모든 키를 읽으려면 키와 `--keys`를 생략하세요.

키 하나에 대한 `get`은 키의 값만 출력합니다. 대신 JSON을 얻으려면 전체 봉투에는 `--output`을, 그 `data`에는
`--data-only`를 전달하세요. 여러 키 또는 모든 키를 읽으면 항상 JSON을 반환합니다.

```bash theme={null}
xbox --playfab-title-id ABC123 playfab title-data get MyKey
```

```text theme={null}
my-value
```

해당 키가 없으면 `get`은 stderr에 `Key 'MyKey' was not found.`를 쓰고 코드 `1`로 종료됩니다.

```bash theme={null}
xbox --playfab-title-id ABC123 playfab title-data get MyKey --internal
xbox --playfab-title-id ABC123 playfab title-data get MyKey --output json
xbox --playfab-title-id ABC123 playfab title-data get --keys MyKey,OtherKey
xbox --playfab-title-id ABC123 playfab title-data get
```

## `playfab title-data set`

| 옵션 | 설명 |
| - | - |
| `--key <key>` | 설정할 키입니다. `--value`와 함께 사용합니다. |
| `--value <value>` | `--key`의 값이며, 그대로 저장됩니다. |
| `--data <data>` | 여러 키를 한 번에 설정하기 위한 키/값 쌍의 JSON 개체입니다. `--key` 및 `--value`와 함께 사용할 수 없습니다. |
| `--internal` | 클라이언트 읽기 가능 타이틀 데이터 대신 내부 타이틀 데이터를 씁니다. |

키 하나를 설정합니다.

```bash theme={null}
xbox --playfab-title-id ABC123 playfab title-data set --key MyKey --value my-value
```

또는 여러 키를 한 번에 설정합니다.

```bash theme={null}
xbox --playfab-title-id ABC123 playfab title-data set --data '{"MyKey":"my-value","OtherKey":"2"}'
```

성공하면 `set`은 `{"applied":["MyKey","OtherKey"]}`처럼 설정한 키를 씁니다.

## `playfab title-data delete`

| 옵션 | 필수 | 설명 |
| - | - | - |
| `--keys <a,b,c>` | 예 | 제거할 쉼표로 구분된 키입니다. |
| `--internal` | 아니요 | 클라이언트 읽기 가능 타이틀 데이터 대신 내부 타이틀 데이터를 제거합니다. |

```bash theme={null}
xbox --playfab-title-id ABC123 playfab title-data delete --keys MyKey,OldKey
```

성공하면 `delete`는 `{"applied":["MyKey","OldKey"]}`처럼 제거한 키를 씁니다.

## 여러 키 쓰기가 도중에 중지되는 경우

`set`과 `delete`는 키를 한 번에 하나씩 순서대로 쓰며, 성공하지 못한 첫 번째 키에서 중지합니다. 그 앞의 키는
쓰였고, 그 뒤의 키는 시도되지 않았습니다. 명령은 코드 `1`로 종료되고 stderr에 요약을 씁니다.

| 필드 | 의미 |
| - | - |
| `applied` | 쓰인 키입니다. |
| `failed` | PlayFab이 거부한 키와 해당 오류입니다. 쓰이지 않았습니다. |
| `unknown` | 시간 초과, Ctrl+C 또는 HTTP 5xx 오류 이후처럼 요청이 확정적인 응답 없이 PlayFab에 도달했을 수 있는 키입니다. 쓰였을 수 있으므로 명령을 다시 실행하기 전에 `title-data get`으로 확인하세요. |
| `notSent` | 로그인에 실패한 경우처럼 요청이 전송되지 않은 키입니다. 쓰이지 않았습니다. |

```json theme={null}
{
  "applied": ["MyKey"],
  "unknown": {
    "key": "OtherKey",
    "error": "The operation was canceled.",
    "outcomeUnknown": "/Admin/SetTitleData may have reached PlayFab, but the request was canceled, so its outcome is unknown. Check whether it was applied before retrying."
  }
}
```


## Related topics

- [타이틀 데이터](https://docs.xbox.com/ko/services/playfab/live-service-management/game-configuration/titledata/index.md)
- [개요 - Winter Starfall](https://docs.xbox.com/ko/services/playfab/demo-game/overview.md)
- [타이틀 데이터 설정](https://docs.xbox.com/ko/services/playfab/api-references/rest/server/title-wide-data-management/set-title-data.md)
- [타이틀 데이터 가져오기](https://docs.xbox.com/ko/services/playfab/api-references/rest/server/title-wide-data-management/get-title-data.md)
- [타이틀 데이터 재정의 삭제](https://docs.xbox.com/ko/services/playfab/api-references/rest/admin/title-wide-data-management/delete-title-data-override.md)
