제한 - Economy(V2)
Important
이제 Economy v2가 일반 공급됩니다. 지원 및 피드백을 받으려면 PlayFab 포럼으로 이동하세요.
이 가이드의 목적은 항목 카탈로그에서 생성하거나 업데이트하거나 읽을 때 적용되는 제한 사항과 해당 항목을 플레이어 인벤토리에서 추가하고 업데이트하며 제거할 때 적용되는 제한 사항을 자세히 설명하는 것입니다. 이제 Economy(V2)에 따라 가장 많이 업데이트된 제한이 포함됩니다.
- 제한(플레이어)은 대상이 되는 엔티티가 플레이어인 경우를 나타냅니다.
- 제한(제목)은 대상 엔터티가 타이틀인 경우를 나타냅니다.
참고 항목
모든 API는 서로 별도로 계산됩니다.
카탈로그 제한
읽음
| API | 제한(플레이어) | 제한(제목) |
|---|---|---|
| GetItem | 1.67 rps(60초내 100) | 1000rps(10초내 10000) |
| GetItems | 1.67 rps(60초내 100) | 1000rps(10초내 10000) |
| SearchItems | 1.67 rps(60초내 100) | 1000rps(10초내 10000) |
| GetItemReviews | 1.67 rps(60초내 100) | 1000rps(10초내 10000) |
| GetItemReviewsSummary | 1.67 rps(60초내 100) | 1000rps(10초내 10000) |
| GetEntityItemReview | 1.67 rps(60초내 100) | 1000rps(10초내 10000) |
| GetItemModerationState | - | 1000rps(10초내 10000) |
쓰기/관리
| API | 제한(플레이어) | 제한(제목) |
|---|---|---|
| CreateDraftItem | 0.33 rps(30초내 10) | 100rps(10초내 1000) |
| CreateUploadUrls | 0.33 rps(30초내 10) | 100rps(10초내 1000) |
| DeleteEntityItemReviews | - | 100rps(10초내 1000) |
| DeleteItem | 0.33 rps(30초내 10) | 100rps(10초내 1000) |
| GetDraftItem | 0.33 rps(30초내 10) | 100rps(10초내 1000) |
| GetDraftItems | 0.33 rps(30초내 10) | 100rps(10초내 1000) |
| GetEntityDraftItems | 0.33 rps(30초내 10) | 100rps(10초내 1000) |
| GetItemPublishStatus | 0.33 rps(30초내 10) | 100rps(10초내 1000) |
| PublishDraftItem | 0.33 rps(30초내 10) | 100rps(10초내 1000) |
| ReportItem | 0.33 rps(30초내 10) | 100rps(10초내 1000) |
| ReportItemReview | 0.33 rps(30초내 10) | 100rps(10초내 1000) |
| ReviewItem | 0.33 rps(30초내 10) | 100rps(10초내 1000) |
| SetItemModerationState | - | 100rps(10초내 1000) |
| SubmitItemReviewVote | 0.33 rps(30초내 10) | 100rps(10초내 1000) |
| TakedownItemReviews | - | 100rps(10초내 1000) |
| UpdateDraftItem | 0.33 rps(30초내 10) | 100rps(10초내 1000) |
인벤토리 제한
참고 항목
- 인벤토리 제한은 각 API에 대해 개별적으로 대상 엔터티를 기반으로 계산됩니다.
- 예를 들어 플레이어 또는 타이틀(게임 서비스, 스크립트 등)이 인벤토리 API를 호출하여 플레이어 엔터티의 인벤토리를 업데이트하는 경우 제한(플레이어) 스로틀링이 적용됩니다.
- 그룹 엔터티 인벤토리도 지원되며, 그룹 엔터티는 플레이어 엔터티와 동일한 제한 속도를 공유합니다. 그룹, 길드 및 클랜도 참조하세요.
읽음
| API | 제한(플레이어) | 제한(제목) |
|---|---|---|
| GetInventoryItems | 1.67 rps(60초내 100) | - |
| GetInventoryCollectionIds | 1.67 rps(60초내 100) | - |
트랜잭션 기록 읽기
| API | 제한(플레이어) | 제한(제목) |
|---|---|---|
| GetTransactionHistory | 0.1 rps(300초내 30) | - |
쓰기
| API | 제한(플레이어) | 제한(제목) |
|---|---|---|
| AddInventoryItems | 0.66 rps(90초내 60) | - |
| SubtractInventoryItems | 0.66 rps(90초내 60) | - |
| UpdateInventoryItems | 0.66 rps(90초내 60) | - |
| PurchaseInventoryItems | 0.66 rps(90초내 60) | - |
| TransferInventoryItems | 0.66 rps(90초내 60) | - |
| DeleteInventoryItems | 0.66 rps(90초내 60) | - |
| ExecuteInventoryOperations | 0.66 rps(90초내 60) | - |
| 인벤토리 수집 삭제 | 0.16 rps(90초내 15) | - |
사용
| API | 제한(플레이어) | 제한(제목) |
|---|---|---|
| RedeemAppleAppStoreInventoryItems | 0.66 rps(90초내 60) | - |
| RedeemGooglePlayInventoryItems | 0.66 rps(90초내 60) | - |
| RedeemMicrosoftStoreInventorItems | 0.66 rps(90초내 60) | - |
| RedeemNintendoEShopInventoryItems | 0.66 rps(90초내 60) | - |
| RedeemPlayStationStoreInventoryItems | 0.66 rps(90초내 60) | - |
| RedeemSteamInventoryItems | 0.66 rps(90초내 60) | - |
API 제한
이진 콘텐츠 크기
허용되는 최대 파일 크기는 500MB입니다.
이진 파일 콘텐츠 수량
최대 100개의 이미지와 100개의 파일을 항목에 추가할 수 있습니다.
- 파일에는 제한이 없습니다.
- 이미지는 .png, .jpg, .gif또는 .bmp 파일 형식을 사용하여 업로드할 수 있습니다.
CreateUploadsUrls
콘텐츠 Blob/URL은 초안 또는 게시된 항목에 연결되지 않은 경우 24시간 후 가비지로 수집됩니다.
카탈로그 최대 페이지 크기
다음은 다양한 API에 대해 반환되는 최대 항목 수입니다. 연속 토큰을 사용하여 제한보다 큰 결과를 반환하는 결과를 페이지로 나눌 수 있습니다.
-
SearchItems- 페이지당 항목 50개 -
GetItems- 페이지당 항목 50개 -
GetItemReviews- 페이지당 항목 50개 -
GetItemContainers- 페이지당 항목 50개 -
GetEntityDraftItems- 페이지당 항목 50개
카탈로그 기본 페이지 크기
-
SearchItems- 페이지당 항목 10개 -
GetItems- 페이지당 항목 10개 -
GetItemReviews- 페이지당 항목 10개 -
GetItemContainers- 페이지당 항목 10개 -
GetDraftItems- 페이지당 항목 10개 -
GetEntityDraftItems- 페이지당 항목 10개
인벤토리 최대 페이지 크기
다음은 다양한 API에 대해 반환되는 최대 항목 수입니다. 연속 토큰을 사용하여 한도보다 큰 결과를 반환하는 결과를 페이지로 나눌 수 있습니다.
| API | 응답 압축을 사용하여 제한 | 응답 압축 없이 제한 |
|---|---|---|
| GetInventoryItems | 250개 항목 | 50개 항목 |
| GetInventoryCollectionIds | 250개 항목 | 50개 항목 |
| GetTransactionHistory | 250개 항목 | 50개 항목 |
인벤토리 기본 페이지 크기
-
GetInventoryItems- 페이지당 항목 10개 -
GetInventoryCollectionIds- 페이지당 항목 10개 -
GetTransactionHistory- 페이지당 항목 10개
검색 필터 복잡성
SearchItems 호출에 사용되는 지나치게 복잡한 Filter 쿼리의 사용을 방지하기 위해 시행되는 검사가 있습니다. 자세한 내용은 여기에서 확인할 수 있습니다.
카탈로그 아이템
타이틀
타일은 국가 코드당 512자 제한이 있습니다.
설명
설명은 국가 코드당 10,000자로 제한됩니다.
키워드
키워드는 키워드당 50자로 제한되며 국가 코드당 최대 32개의 키워드를 추가할 수 있습니다.
디스플레이 속성
표시 속성 필드에는 10000 바이트 제한이 있습니다.
태그
태그에는 태그당 32자 제한이 있습니다. 타이틀은 최대 1,024개의 태그를 가질 수 있으며 최대 32개의 태그를 항목에 추가할 수 있습니다.
콘텐츠 형식
콘텐츠 유형은 콘텐츠 유형당 32자 제한이 있습니다. 타이틀은 최대 128개의 콘텐츠 유형을 가질 수 있습니다.
PricesOptions
가격 옵션 목록의 길이 제한은 15가지 가격 옵션입니다.
금액
금액 목록의 길이 제한은 15입니다.
UnitDurationInSeconds
단위 기간의 제한은 100년 (3,155,695,200초)입니다.
AlternateIds
각 대체 ID의 값 길이 제한은 100자입니다.
대체 ID의 목록 길이는 15개의 대체 ID로 제한됩니다.
DisplayVersion
표시 버전 필드의 값 길이 제한은 50자입니다.
ClientVersion
클라이언트 버전에는 3개 세그먼트 제한이 있으며 각 세그먼트는 값으로 최대 65535까지 허용합니다.
예: "1.65535.234".
ItemReferences
ItemReferences 필드는 250개 항목으로 제한됩니다.
카탈로그 구성
AdminEntities
관리 엔터티 목록에는 64개 엔터티 제한이 있습니다.
ReviewerEntities
관리 엔터티 목록에는 128개 엔터티 제한이 있습니다.
딥 링크
딥 링크의 최대 개수는 10 링크입니다.
DisplayPropertyIndexInfo
각 표시 속성 유형당 5개 값으로 제한됩니다.
콘텐츠 형식
콘텐츠 형식 목록은 128개 형식으로 제한되며, 각각 최대 길이는 40자입니다.
플랫폼
플랫폼 목록은 128개 플랫폼으로 제한되며, 각각 최대 길이는 40자입니다.
태그
태그 목록은 1024개의 태그로 제한되며, 각각 최대 길이는 32자입니다.
플레이어 인벤토리
Batch 작업
실행할 인벤토리 작업의 최대 수는 50개 작업입니다.
수정할 최대 항목 수는 300개 항목입니다.
(예를 들어 하나의 전체 번들 및 최대 50개의 다른 항목을 추가할 수 있습니다.)
인벤토리 컬렉션
최대 컬렉션 크기는 10000개 항목입니다.
컬렉션 목록의 길이는 제한되지 않습니다.
컬렉션 이름의 문자 제한은 75자입니다.
트랜잭션 기록
트랜잭션 기록의 최대 날짜 범위는 무제한입니다.
기본 날짜 범위는 6개월입니다.
인벤토리 항목
디스플레이 속성
표시 속성 필드에는 1000바이트 제한이 있습니다.