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

# Economy V2 제한

> 플레이어별 및 타이틀별 초당 요청 할당량을 포함하여 PlayFab Economy v2 카탈로그 및 인벤토리 API에 대한 제한 및 속도 제한 참조입니다.

# 제한 - Economy (V2)

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

이 가이드의 목적은 아이템 카탈로그를 만들고, 업데이트하고, 읽고 플레이어 인벤토리에서 추가, 업데이트, 제거할 때 시행되는 제한을 자세히 설명하는 것입니다. 이제 Economy (V2)에 따른 가장 최신 제한이 포함되어 있습니다.

* Limit (Player)는 대상이 되는 엔터티가 Player일 때를 나타냅니다.
* Limit (Title)은 대상이 되는 엔터티가 Title일 때를 나타냅니다.

<Note>
  모든 API는 서로 별도로 계산됩니다.
</Note>

## Catalog Throttling

### 읽기

| **API**                    | **Limit (Player)**   | **Limit (Title)**      |
| -------------------------- | -------------------- | ---------------------- |
| **GetItem**                | 1.67 rps (60초당 100회) | 1000 rps (10초당 10000회) |
| **GetItems**               | 1.67 rps (60초당 100회) | 1000 rps (10초당 10000회) |
| **SearchItems**            | 1.67 rps (60초당 100회) | 1000 rps (10초당 10000회) |
| **GetItemReviews**         | 1.67 rps (60초당 100회) | 1000 rps (10초당 10000회) |
| **GetItemReviewsSummary**  | 1.67 rps (60초당 100회) | 1000 rps (10초당 10000회) |
| **GetEntityItemReview**    | 1.67 rps (60초당 100회) | 1000 rps (10초당 10000회) |
| **GetItemModerationState** | -                    | 1000 rps (10초당 10000회) |

### 쓰기/관리

| **API**                     | **Limit (Player)**  | **Limit (Title)**    |
| --------------------------- | ------------------- | -------------------- |
| **CreateDraftItem**         | 0.33 rps (30초당 10회) | 100 rps (10초당 1000회) |
| **CreateUploadUrls**        | 0.33 rps (30초당 10회) | 100 rps (10초당 1000회) |
| **DeleteEntityItemReviews** | -                   | 100 rps (10초당 1000회) |
| **DeleteItem**              | 0.33 rps (30초당 10회) | 100 rps (10초당 1000회) |
| **GetDraftItem**            | 0.33 rps (30초당 10회) | 100 rps (10초당 1000회) |
| **GetDraftItems**           | 0.33 rps (30초당 10회) | 100 rps (10초당 1000회) |
| **GetEntityDraftItems**     | 0.33 rps (30초당 10회) | 100 rps (10초당 1000회) |
| **GetItemPublishStatus**    | 0.33 rps (30초당 10회) | 100 rps (10초당 1000회) |
| **PublishDraftItem**        | 0.33 rps (30초당 10회) | 100 rps (10초당 1000회) |
| **ReportItem**              | 0.33 rps (30초당 10회) | 100 rps (10초당 1000회) |
| **ReportItemReview**        | 0.33 rps (30초당 10회) | 100 rps (10초당 1000회) |
| **ReviewItem**              | 0.33 rps (30초당 10회) | 100 rps (10초당 1000회) |
| **SetItemModerationState**  | -                   | 100 rps (10초당 1000회) |
| **SubmitItemReviewVote**    | 0.33 rps (30초당 10회) | 100 rps (10초당 1000회) |
| **TakedownItemReviews**     | -                   | 100 rps (10초당 1000회) |
| **UpdateDraftItem**         | 0.33 rps (30초당 10회) | 100 rps (10초당 1000회) |

## Inventory Throttling

<Note>
  * Inventory 제한은 각 API에 대해 개별적으로 대상 엔터티를 기준으로 계산됩니다. - 예를 들어, 플레이어 또는 타이틀(게임 서비스, CloudScript 등)이 플레이어 엔터티의 인벤토리를 업데이트하기 위해 Inventory API를 호출하는 경우 Limit (Player) 제한이 적용됩니다. - [Group entity](/services/playfab/live-service-management/game-configuration/entities#group) 인벤토리도 지원되며 Group Entities는 Player 엔터티와 동일한 제한율을 공유합니다. [Groups](/services/playfab/community/associations/groups)도 참조하세요.
</Note>

### 읽기

| **API**                       | **Limit (Player)**  | **Limit (Title)** |
| ----------------------------- | ------------------- | ----------------- |
| **GetInventoryItems**         | 0.67 rps (60초당 40회) | -                 |
| **GetInventoryCollectionIds** | 0.08 rps (60초당 5회)  | -                 |

### 트랜잭션 이력 읽기

| **API**                   | **Limit (Player)**  | **Limit (Title)** |
| ------------------------- | ------------------- | ----------------- |
| **GetTransactionHistory** | 0.1 rps (300초당 30회) | -                 |

### 쓰기

| **API**                        | **Limit (Player)**  | **Limit (Title)** |
| ------------------------------ | ------------------- | ----------------- |
| **AddInventoryItems**          | 0.33 rps (60초당 20회) | -                 |
| **SubtractInventoryItems**     | 0.33 rps (60초당 20회) | -                 |
| **UpdateInventoryItems**       | 0.33 rps (60초당 20회) | -                 |
| **PurchaseInventoryItems**     | 0.33 rps (60초당 20회) | -                 |
| **TransferInventoryItems**     | 0.33 rps (60초당 20회) | -                 |
| **DeleteInventoryItems**       | 0.33 rps (60초당 20회) | -                 |
| **ExecuteInventoryOperations** | 0.33 rps (60초당 20회) | -                 |
| **DeleteInventoryCollection**  | 0.08 rps (60초당 5회)  | -                 |

### Redeem

| **API**                                  | **Limit (Player)**  | **Limit (Title)** |
| ---------------------------------------- | ------------------- | ----------------- |
| **RedeemAppleAppStoreInventoryItems**    | 0.16 rps (60초당 10회) | -                 |
| **RedeemGooglePlayInventoryItems**       | 0.16 rps (60초당 10회) | -                 |
| **RedeemMicrosoftStoreInventoryItems**   | 0.16 rps (60초당 10회) | -                 |
| **RedeemNintendoEShopInventoryItems**    | 0.16 rps (60초당 10회) | -                 |
| **RedeemPlayStationStoreInventoryItems** | 0.16 rps (60초당 10회) | -                 |
| **RedeemSteamInventoryItems**            | 0.16 rps (60초당 10회) | -                 |

## API 제한

### 바이너리 콘텐츠 크기

허용되는 최대 파일 크기는 **500MB**입니다.

### 바이너리 콘텐츠 수량

아이템당 최대 **100개의 이미지**와 **100개의 파일**을 추가할 수 있습니다.

* 파일에는 제한이 없습니다.
* 이미지는 **.png**, **.jpg**, **.gif** 또는 **.bmp** 파일 형식만 사용하여 업로드할 수 있습니다.

### CreateUploadsUrls

드래프트 또는 게시된 아이템에 첨부되지 **않은** 콘텐츠 blob/URL은 **24시간** 후에 가비지 컬렉션됩니다.

### 카탈로그 최대 페이지 크기

다음은 다양한 API에 대해 반환되는 최대 아이템 수입니다. [continuation token](/services/playfab/economy-monetization/economy-v2/catalog/search#continuation-tokens)을 사용하여 제한을 초과하여 반환되는 결과를 페이지 매김할 수 있습니다.

* `SearchItems` - 페이지당 50개 아이템
* `GetItems` - 페이지당 50개 아이템
* `GetItemReviews` - 페이지당 50개 아이템
* `GetItemContainers` - 페이지당 50개 아이템
* `GetEntityDraftItems` - 페이지당 50개 아이템

### 카탈로그 기본 페이지 크기

* `SearchItems` - 페이지당 10개 아이템
* `GetItems` - 페이지당 10개 아이템
* `GetItemReviews` - 페이지당 10개 아이템
* `GetItemContainers` - 페이지당 10개 아이템
* `GetDraftItems` - 페이지당 10개 아이템
* `GetEntityDraftItems` - 페이지당 10개 아이템

### 인벤토리 최대 페이지 크기

다음은 다양한 API에 대해 반환되는 최대 아이템 수입니다. [continuation token](/services/playfab/economy-monetization/economy-v2/catalog/search#continuation-tokens)을 사용하여 제한을 초과하여 반환되는 결과를 페이지 매김할 수 있습니다.

| **API**                       | **응답 압축 사용 시 제한** | **응답 압축 미사용 시 제한** |
| ----------------------------- | ----------------- | ------------------ |
| **GetInventoryItems**         | 250개 아이템          | 50개 아이템            |
| **GetInventoryCollectionIds** | 250개 아이템          | 50개 아이템            |
| **GetTransactionHistory**     | 250개 아이템          | 50개 아이템            |

### 인벤토리 기본 페이지 크기

* `GetInventoryItems` - 페이지당 10개 아이템
* `GetInventoryCollectionIds` - 페이지당 10개 아이템
* `GetTransactionHistory` - 페이지당 10개 아이템

### 검색 필터 복잡도

`SearchItems` 호출에서 사용되는 지나치게 복잡한 `Filter` 쿼리 사용을 방지하기 위한 검사가 시행됩니다. 자세한 정보는 [여기](/services/playfab/economy-monetization/economy-v2/catalog/search#limits)에서 찾을 수 있습니다.

## Catalog Item

### 카탈로그 작성자 엔터티 제한

Catalog 작성자 엔터티당 최대 20GB의 카탈로그 데이터가 허용됩니다. 이 제한은 Title 엔터티가 만든 Catalog Items에 가장 자주 발생할 가능성이 높습니다.

### Titles

Title은 국가 코드당 **512자 제한**을 갖습니다.

### Descriptions

Description은 국가 코드당 **10000자 제한**을 갖습니다.

### Keywords

Keywords는 키워드당 **50자 제한**이 있고 국가 코드당 최대 **32개의 키워드**를 추가할 수 있습니다.

### Display Properties

Display Properties 필드는 **10000바이트 제한**을 갖습니다.

### Tags

Tags는 태그당 **32자 제한**을 갖습니다.
Titles은 최대 **1024개의 Tags**를 가질 수 있으며
아이템에 최대 **32개의 Tags**를 추가할 수 있습니다.

### Content Types

Content Types는 콘텐츠 형식당 **32자 제한**을 갖습니다.
Titles은 최대 **128개의 Content Types**를 가질 수 있습니다.

### PricesOptions

가격 옵션 목록의 길이 제한은 **15개의 가격 옵션**입니다.

### Amounts

금액 목록의 길이 제한은 **15개의 금액**입니다.

### UnitDurationInSeconds

단위 기간은 **100년**의 제한(3,155,695,200초)이 있습니다.

### AlternateIds

각 alternate ID는 **100자**의 값 길이 제한을 갖습니다.

alternate ID 목록 길이는 **15개의 alternate ID** 제한이 있습니다.

### DisplayVersion

display 버전 필드는 **50자**의 값 길이 제한을 갖습니다.

### ClientVersion

client 버전은 **3세그먼트 제한**이 있으며 각 세그먼트는 **65535**의 최대값을 허용합니다.
예: "1.65535.234".

### ItemReferences

ItemReferences 필드는 **250개 아이템**의 제한을 갖습니다.

## Catalog Config

### AdminEntities

관리자 엔터티 목록은 **64개 엔터티 제한**이 있습니다.

### ReviewerEntities

관리자 엔터티 목록은 **128개 엔터티 제한**이 있습니다.

### Deep Links

deep link의 최대 수는 **10개 링크**입니다.

### DisplayPropertyIndexInfo

각 display 속성 유형당 **5개 값** 제한이 있습니다.

### Content Types

콘텐츠 유형 목록은 **128개 유형** 제한이 있으며 각각 **40자**의 최대 길이를 가집니다.

### Platforms

플랫폼 목록은 **128개 플랫폼** 제한이 있으며 각각 **40자**의 최대 길이를 가집니다.

### Tags

태그 목록은 **1024개 태그** 제한이 있으며 각각 **32자**의 최대 길이를 가집니다.

## Player Inventory

### 일괄 작업

실행할 인벤토리 작업의 최대 수는 **50개 작업**입니다.

수정할 아이템의 최대 수는 **300개 아이템**입니다.
(예: 하나의 전체 번들과 최대 50개의 다른 아이템을 추가할 수 있음)

### Inventory Collections

컬렉션 최대 크기는 **10000개 아이템**입니다.

엔터티당 컬렉션 목록 길이 제한은 **1000개 컬렉션**입니다.

컬렉션 이름의 문자 제한은 **75자**입니다.

### 트랜잭션 이력

트랜잭션 이력의 최대 날짜 범위는 **4년**입니다.

기본 날짜 범위는 **6개월**입니다.

## Inventory Item

### Display Properties

display 속성 필드는 1000바이트 제한을 갖습니다.


## Related topics

- [스로틀링 모범 사례](/ko/services/playfab/live-service-management/service-gateway/throttling/best-practices.md)
- [PlayFab의 스로틀링](/ko/services/playfab/live-service-management/service-gateway/throttling/what-is-throttling.md)
- [Economy v2 개요](/ko/services/playfab/economy-monetization/economy-v2/overview.md)
- [Economy v2 설정 개요](/ko/services/playfab/economy-monetization/economy-v2/settings.md)
- [Economy V2 TurboLoading](/ko/services/playfab/economy-monetization/economy-v2/inventory/turboloading.md)