Skip to main content

제한 - Economy (V2)

Economy v2는 이제 정식으로 사용할 수 있습니다(GA). 지원 및 피드백은 PlayFab Forum을 방문하세요.
이 가이드의 목적은 아이템 카탈로그를 만들고, 업데이트하고, 읽고 플레이어 인벤토리에서 추가, 업데이트, 제거할 때 시행되는 제한을 자세히 설명하는 것입니다. 이제 Economy (V2)에 따른 가장 최신 제한이 포함되어 있습니다.
  • Limit (Player)는 대상이 되는 엔터티가 Player일 때를 나타냅니다.
  • Limit (Title)은 대상이 되는 엔터티가 Title일 때를 나타냅니다.
모든 API는 서로 별도로 계산됩니다.

Catalog Throttling

읽기

쓰기/관리

Inventory Throttling

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

읽기

트랜잭션 이력 읽기

쓰기

Redeem

API 제한

바이너리 콘텐츠 크기

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

바이너리 콘텐츠 수량

아이템당 최대 100개의 이미지100개의 파일을 추가할 수 있습니다.
  • 파일에는 제한이 없습니다.
  • 이미지는 .png, .jpg, .gif 또는 .bmp 파일 형식만 사용하여 업로드할 수 있습니다.

CreateUploadsUrls

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

카탈로그 최대 페이지 크기

다음은 다양한 API에 대해 반환되는 최대 아이템 수입니다. continuation token을 사용하여 제한을 초과하여 반환되는 결과를 페이지 매김할 수 있습니다.
  • 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을 사용하여 제한을 초과하여 반환되는 결과를 페이지 매김할 수 있습니다.

인벤토리 기본 페이지 크기

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

검색 필터 복잡도

SearchItems 호출에서 사용되는 지나치게 복잡한 Filter 쿼리 사용을 방지하기 위한 검사가 시행됩니다. 자세한 정보는 여기에서 찾을 수 있습니다.

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 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바이트 제한을 갖습니다.
마지막 수정일 2026년 8월 13일