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

# player_inventory_item_added

> player_inventory_item_added 이벤트입니다.

이 이벤트는 항목이 플레이어에게 부여될 때 트리거됩니다.

## 속성

| 이름             | 형식       | 설명                                                |
| :------------- | :------- | :------------------------------------------------ |
| Annotation     | String   | 인벤토리 항목에 대한 선택적 세부 정보입니다.                         |
| BundleContents | \[]      | 이 항목과 함께 번들의 일부로 플레이어에게 부여된 다른 항목의 카탈로그 항목 ID입니다. |
| CatalogVersion | String   | 추가된 항목이 정의된 카탈로그 버전입니다.                           |
| Class          | String   | 추가된 항목의 클래스입니다.                                   |
| CouponCode     | String   | 항목을 부여한 쿠폰(있는 경우)의 사용 코드입니다.                      |
| DisplayName    | String   | 추가된 항목의 표시 이름입니다.                                 |
| Expiration     | DateTime | 항목의 만료 시점입니다. 항목이 만료되지 않는 경우 값은 null입니다.          |
| InstanceId     | String   | 추가된 인벤토리 항목의 고유 인스턴스 ID입니다.                       |
| ItemId         | String   | 추가된 인벤토리 항목의 카탈로그 항목 ID입니다.                       |
| RemainingUses  | uint32   | 사용 횟수가 제한된 경우, 항목의 남은 사용 횟수입니다.                   |
| 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](/services/playfab/api-references/events/data-types/sourcetype) | 이 이벤트 소스의 유형입니다(PlayFab 파트너, 기타 백엔드 또는 PlayFab API).                                                                                                                                                                                    |
| Timestamp      | DateTime                                                                    | 이 이벤트와 연결된 시간(UTC)입니다.                                                                                                                                                                                                                  |


## Related topics

- [PlayFab의 PlayStream 이벤트 모델 참조](/ko/services/playfab/api-references/events/index.md)
- [character_inventory_item_added](/ko/services/playfab/api-references/events/Character/character-inventory-item-added.md)
- [items_added](/ko/services/playfab/api-references/events/Inventory/items-added.md)
- [Inventory Stacks](/ko/services/playfab/economy-monetization/economy-v2/inventory/stacks.md)
- [Player Inventory 빠른 시작](/ko/services/playfab/economy-monetization/economy-v2/inventory/quickstart.md)