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

# 아이템 및 인벤토리 개요

> 아이템 유형, 번들, 스토어, 가상 화폐 및 플레이어 소유권 추적을 포함한 PlayFab Economy v2 카탈로그 및 인벤토리 개념을 알아봅니다.

# PlayFab 아이템 및 인벤토리 개요

<Info>
  Economy v2는 이제 정식으로 사용할 수 있습니다(GA). 지원 및 피드백은 [PlayFab Forum](https://community.playfab.com)을 방문하세요.
</Info>

아이템과 인벤토리는 몰입감 있고 매력적인 게임을 만들기 위한 필수 기능입니다. 이를 통해 플레이어에게 사용자 지정 옵션, 보상, 진행 시스템 및 수익화 기회를 제공할 수 있습니다.

PlayFab Economy v2는 가상 상품을 만들고 관리하기 위한 유연하고 강력한 플랫폼을 제공합니다. 지속형, 소모품, 번들, 구독, 가상 화폐 등 다양한 유형의 아이템을 정의하고 플레이어의 인벤토리 전반에 걸쳐 아이템의 소유권과 사용을 추적할 수 있습니다.

## 주요 개념

* **Catalog** - Catalog는 게임에서 사용할 수 있는 모든 아이템의 컬렉션입니다. Catalog는 게임의 가상 아이템을 관리하는 쉬운 방법을 제공합니다. 자세한 내용은 [Catalog 개요](/services/playfab/economy-monetization/economy-v2/catalog/catalog-overview)를 참조하세요.
* **Catalog Items** – 카탈로그에 정의된 개별 아이템입니다. 무기, 의상, 파워업, 전리품 상자 등과 같은 모든 종류의 가상 상품을 나타낼 수 있습니다. 게임 디자인에 맞게 속성과 동작을 사용자 지정할 수 있습니다.
* **Catalog Stores** - 스토어를 사용하면 시즌 이벤트, 프로모션, 테스트 등 다양한 목적을 위해 여러 아이템 목록을 만들 수 있습니다. [스토어](/services/playfab/economy-monetization/economy-v2/catalog/stores)를 참조하세요.
* **번들** - 번들은 다른 아이템에 대한 참조를 포함하는 카탈로그 아이템입니다. 플레이어가 번들을 구매하면 참조된 아이템이 언패킹되어 인벤토리에 추가됩니다.
* **구독** - 구독은 지속형 상품에 대한 시간 기반 액세스를 부여합니다. 구독 내 아이템은 구독 기간 동안 플레이어의 인벤토리에서 사용할 수 있습니다. [구독](/services/playfab/economy-monetization/economy-v2/catalog/subscriptions)을 참조하세요.
* **Player Inventory Collections** - 인벤토리는 플레이어가 게임에서 소유하고 있는 아이템의 기록입니다. 여기에는 아이템 수량, 가상 화폐 잔액 및 사용자 지정 속성에 대한 정보가 포함됩니다. 모든 플레이어 계정은 [Collections](/services/playfab/economy-monetization/economy-v2/inventory/collections)라고 하는 하나 이상의 인벤토리를 가질 수 있습니다.
* **Stacks** - Stacks를 사용하면 동일한 아이템의 여러 별개 인스턴스가 각각의 수량과 사용자 지정 속성과 함께 단일 인벤토리에 존재할 수 있습니다. [Stacks](/services/playfab/economy-monetization/economy-v2/inventory/stacks)를 참조하세요.
* **Virtual Currency** - 가상 화폐는 게임에서 교환 수단으로 사용되는 아이템 유형입니다. 가상 화폐를 사용하여 카탈로그나 스토어에서 아이템을 구매하거나, 인앱 구매의 소프트 통화를 구현하거나, 게임 플레이 메커니즘을 이끌 수 있습니다.

## 주요 API

게임에서 아이템과 인벤토리와 상호 작용하기 위한 풍부한 API 세트를 사용할 수 있습니다. 이러한 API를 사용하여 아이템 구매, 아이템 부여, 인벤토리 업데이트, 플레이어 간 아이템 이전, 트랜잭션 이력 쿼리 등의 작업을 수행할 수 있습니다.

### 인벤토리 관리

* **[GetInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/get-inventory-items)** - 엔터티의 현재 인벤토리를 검색합니다. `ContinuationToken`으로 페이지 매김을 지원하고 [TurboLoading](/services/playfab/economy-monetization/economy-v2/inventory/turboloading)을 통해 대량 로드를 지원합니다.
* **[AddInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/add-inventory-items)** - 아이템을 플레이어의 인벤토리에 직접 추가합니다.
* **[SubtractInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/subtract-inventory-items)** - 플레이어의 인벤토리에서 아이템 수량을 줄입니다.
* **[UpdateInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/update-inventory-items)** - 인벤토리 아이템의 수량을 설정하거나 [Display Properties](/services/playfab/economy-monetization/economy-v2/inventory#display-properties)를 수정합니다.
* **[DeleteInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/delete-inventory-items)** - 플레이어의 인벤토리에서 아이템 스택 전체를 제거합니다.

### 구매 및 거래

* **[PurchaseInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/purchase-inventory-items)** - 가상 화폐를 사용하여 카탈로그 아이템이나 번들을 구매합니다. 플레이어의 인벤토리에서 통화를 차감하고 구매한 아이템을 부여합니다.
* **[TransferInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/transfer-inventory-items)** - 플레이어 간, 플레이어의 인벤토리 컬렉션 간 또는 동일한 인벤토리 내 스택 간에 아이템을 이전합니다.

### 일괄 작업

* **[ExecuteInventoryOperations](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/execute-inventory-operations)** - 단일 원자적 요청에서 최대 10개의 인벤토리 작업(Add, Subtract, Update, Purchase, Transfer, Delete)을 일괄 처리합니다. 어떤 작업이든 실패하면 전체 일괄 작업이 롤백됩니다.

### 이력 및 진단

* **[GetTransactionHistory](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/get-transaction-history)** - 플레이어의 인벤토리에서 트랜잭션 이벤트를 검색합니다. 전체 작업 이력을 검토하기 위해 타임스탬프별 필터링과 페이지 매김을 지원합니다. [트랜잭션 이력](/services/playfab/economy-monetization/economy-v2/inventory/transaction-history)을 참조하세요.

### 안정성

* **멱등성** - 모든 인벤토리 API는 중복 부작용 없이 요청을 안전하게 재시도하기 위해 `IdempotencyId` 매개 변수를 지원합니다. ID는 14일 동안 적용됩니다. [멱등성](/services/playfab/economy-monetization/economy-v2/inventory#idempotency)을 참조하세요.

전체 API 참조와 각 작업에 대한 자세한 예제는 [Inventory API 문서](/services/playfab/economy-monetization/economy-v2/inventory)와 [PlayFab REST API 참조](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory)를 참조하세요.


## Related topics

- [플레이어 인벤토리 사용](/ko/services/playfab/player-progression/player-data/player-inventory.md)
- [빠른 시작](/ko/services/playfab/economy-monetization/economy-v2/quickstart.md)
- [Economy(레거시)에서의 쿠폰 및 프로모션](/ko/services/playfab/economy-monetization/economy/tutorials/coupons-and-promotions.md)
- [Player Inventory 빠른 시작](/ko/services/playfab/economy-monetization/economy-v2/inventory/quickstart.md)
- [PlayFab Inventory API](/ko/services/playfab/economy-monetization/economy-v2/inventory/index.md)