# 카탈로그 스키마

> 현지화된 콘텐츠, 가격, 웹숍 디스플레이 메타데이터 등 카탈로그의 리스트를 정의하는 데 사용할 수 있는 필드를 찾습니다.

카탈로그 스키마는 IAP 카탈로그의 카탈로그 나열 구조를 정의합니다. 각 리스트에는 핵심 ID, 현지화된 디스플레이 콘텐츠, 가격, 선택적인 스토어 메타데이터가 나와 있습니다.

모든 필드가 리스트에 적용되는 것은 아닙니다. 웹숍을 통해 판매하는 경우 추가 표시 옵션으로 리스트를 확장할 수 있습니다. [웹숍 확장자 필드](./dashboard-catalog/add-catalog-item.md#webshop-fields)를 참조하십시오.

## 나열 스키마##listing-schema

카탈로그 리스트를 생성할 때 사용할 수 있는 다음 필드를 참고하십시오.

**catalogListingId** (string, required): 이 목록의 고유 식별자로, `uSKU`와는 다릅니다. 동일한 게임 내 아이템에 대한 고유 리스트를 허용합니다.**uSKU** (string, required): 제품의 고유 식별자(SKU)입니다. 1\~141자, 문자, 숫자, `.`, `_`, `-` 문자로 제한됩니다.**type** (string, required): 제품 유형입니다. `Consumable`, `NonConsumable`, 또는 `Subscription` 중 하나입니다.**imageUrl** (string): 리스트의 표준 이미지 에셋의 절대 HTTPS URL입니다.**productDetails** (object\[], required): 지원 언어당 한 개의 엔트리가 포함된 목록의 현지화된 콘텐츠입니다. 최소 하나의 엔트리를 포함해야 합니다.**language** (string, required): 이 항목에 대한 BCP 47 언어 태그(예: `en-US`, `es-ES`).**title** (string, required): 현지화된 리스트 타이틀. 최대 50자.**subtitle** (string): 현지화된 리스트 자막. 최대 50자.**description** (string): 플레이어에게 표시되는 현지 리스트 설명입니다. 최대 250자입니다.**badge** (object): 리스트에 표시되는 프로모션 배지입니다.**text** (string, required): 배지 레이블 텍스트(예: `+125`, `25% OFF`)**imageUrl** (string): 배지 이미지 에셋의 절대 HTTPS URL입니다.**pricing** (object\[], required): 지원되는 각 통화의 가격 지정 항목입니다. 최소 하나의 항목을 포함하고, `USD` 항목을 포함해야 합니다.**currencyCode** (string, required): ISO 4217 통화 코드(예: `USD`, `EUR`).**amount** (integer, required): 제품에 대해 청구되는 금액(마이크로(1,000,000마이크로 = 통화 단위 1)입니다. 예를 들어 `9990000`는 9.99입니다. 0보다 커야 합니다.**webshopPrice** (integer): 웹숍에 표시되는 가격(마이크로)입니다. 제품에 웹별 가격을 지정하려면 이 옵션을 설정합니다.**storeIdOverrides** (object): 네이티브 스토어의 `uSKU`를 오버라이드하는 스토어별 제품 ID입니다.**store** (string, required): 이 오버라이드가 적용되는 스토어입니다. `apple` 또는 `google` 중 하나입니다.**value** (string, required): The store-specific product identifier.

## 예제 카탈로그##example-catalog

다음 카탈로그 리스트에는 기본 카탈로그 필드와 웹숍 확장 필드가 모두 포함됩니다. 가격은 마이크로 단위로 표시되며, 1,000,000은 통화 단위 1개입니다.

```json
[
  {
    "catalogListingId": "gems_medium_default",
    "uSKU": "com.example.gems.medium",
    "type": "소모품",
    "imageUrl": "https://cdn.example.com/gems-medium.png",
    "productDetails": [
      {
        "language": "en",
        "title": "Medium Gem Pack",
        "description": "게임에서 소모할 수 있는 유용한 보석"
        "subtitle": "500 gems",
        "badge": { "text": "최고의 가치", "imageUrl": "https://cdn.example.com/gem-icon.png" }
      }
    ],
    "pricing": [
      { "currencyCode": "USD", "amount": 9990000, "webshopPrice": 7990000 }
    ],
    "categories": ["gems"],
    "hdImages": [
      { "url": "https://cdn.example.com/gems-medium-hd.png", "altText": "보석 쌓기" }
    ],
    "promotion": { "type": "Sale", "endsAt": "2026-07-01T00:00:00Z" },
    "sortIndex": 10
  }
]
```

## 추가 리소스##additional-resources

* 카탈로그를 만드는 가장 좋은 방법을 이해하려면 [IAP 카탈로그 만들기](./catalogs.md)를 참고하십시오.
* 대시보드에서 [카탈로그를 관리합니다](./dashboard-catalog/_index.md).