# カタログスキーマ

> ローカライズされたコンテンツ、価格、ウェブショップのディスプレイメタデータなど、カタログのリストを定義するために使用できるフィールドを見つけます。

カタログスキーマは、IAP カタログ内のカタログリストの構造体を定義します。各リストには、そのコア ID、ローカライズされたディスプレイコンテンツ、価格、任意のストアメタデータが記載されています。

すべてのフィールドがすべてのリストに適用されるわけではありません。ウェブショップを通じて販売する場合は、追加のディスディスプレイでリスティングを拡張できます。[Webshop 拡張子フィールド](./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): サポートされている言語ごとに 1 エントリーを持つ、リストのローカライズされたコンテンツ。少なくとも 1 つのエントリーが含まれている必要があります。**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): サポートされている各通貨の価格エントリー。少なくとも 1 つのエントリーを含み、`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

以下のカタログリストには、基本カタログフィールドと Webshop 拡張子フィールドの両方が含まれています。価格はマイクロ単位で表されます。1,000,000 は通貨の 1 単位です。

```json

  {
    "catalogListingId": "gems_medium_default",
    "uSKU": "com.example.gems.medium",
    "type":"Consumable",
    "imageUrl": "https://cdn.example.com/gems-medium.png",
    "productDetails": [
      {
        "language": "en",
        "title":"ミディアムジェムパック",
        "description": "ゲームで使う宝石の便利な隠し場所",
        "subtitle":"500 gems",
        "badge": { "text":"Best value", "imageUrl": "https://cdn.example.com/gem-icon.png" }
      }
    ],
    "pricing": [
      { "currencyCode":"USD", "amount":9990000, "webshopPrice":"25270591"
    ],
    "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)を管理します。