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

# player_banned

> player_banned 이벤트입니다.

이 이벤트는 플레이어가 차단될 때 트리거됩니다.

## 속성

| 이름 | 형식 | 설명 |
| :- | :- | :- |
| BanExpiration | DateTime | 차단이 만료되는 시점입니다. 차단이 영구적인 경우 값은 null입니다. |
| BanId | String | 차단의 ID입니다. 플레이어가 이전에 차단된 적이 있는 경우 고유한 차단을 추적하는 데 유용합니다. |
| BanReason | String | 플레이어가 차단된 이유입니다. |
| PermanentBan | Boolean | 이 차단이 영구적인지 여부입니다. |
| TitleId | String | 이 플레이어 이벤트가 적용되는 타이틀의 ID입니다. |

## 공통 속성

모든 V1 PlayStream 이벤트는 JSON 객체 형식이며 다음과 같은 공통 속성을 공유합니다:

| 이름 | 형식 | 설명 |
| :- | :- | :- |
| EntityId | String | 이 이벤트가 적용되는 엔터티(타이틀, 플레이어 등)의 식별자입니다. |
| EntityType | String | 이 이벤트가 적용되는 엔터티의 유형(플레이어, 타이틀 등)입니다. PlayFab이 이 엔터티에 대해 작업을 수행해야 하는 경우 EntityType은 반드시 'player', 'character' 또는 'title'이어야 합니다. PlayFab이 현재 구문 분석하지 않는 엔터티 유형은 언제든지 루트 엔터티 구문 분석이 시작될 수 있으므로 네임스페이스(예: 'com.mygame.guild')를 앞에 붙여야 합니다. |
| EventId | String | 이 이벤트에 대해 PlayFab이 할당한 고유 식별자입니다. |
| EventName | String | 이 이벤트의 이름입니다. |
| EventNamespace | String | 이 이벤트에 할당된 네임스페이스입니다. 예: 'com.myprogram.ads' |
| Source | String | 이 PlayStream 이벤트의 소스 이름입니다. 이벤트가 PlayFab에서 발생한 경우 PlayFab이 됩니다. |
| SourceType | [SourceType](https://docs.xbox.com/ko/services/playfab/api-references/events/data-types/sourcetype.md) | 이 이벤트 소스의 유형입니다(PlayFab 파트너, 기타 백엔드 또는 PlayFab API). |
| Timestamp | DateTime | 이 이벤트와 연결된 시간(UTC)입니다. |


## Related topics

- [PlayStream 이벤트 모델 참조](https://docs.xbox.com/ko/services/playfab/api-references/events/index.md)
- [Link Android Device ID](https://docs.xbox.com/api-reference/account-management/link-android-device-id.md)
- [Link Custom ID](https://docs.xbox.com/api-reference/account-management/link-custom-id.md)
- [Android 디바이스 ID 연결](https://docs.xbox.com/ko/services/playfab/api-references/rest/client/account-management/link-android-device-id.md)
- [사용자 지정 ID 연결](https://docs.xbox.com/ko/services/playfab/api-references/rest/client/account-management/link-custom-id.md)