# 目录架构

> 查找可用于在目录中定义列表的字段，包括本地化内容、定价和网上商店展示元数据。

目录架构定义了 IAP 目录中目录列表的结构。每个列表描述了其核心标识、本地化显示内容、定价和可选的商店元数据。

并非所有字段都适用于每个列表。如果通过网上商店销售，可使用其他显示选项扩展列表。请参阅 [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): 列表的本地化内容，每种支持的语言有一个条目。必须至少包含一个条目。**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 micros = 1 个货币单位）。例如， `9990000` 为 9.99。必须大于 0。**webshopPrice** (integer): 网上商店上显示的价格（以微缩为单位）。设置此选项可为商品提供特定于 Web 的价格。**storeIdOverrides** (object): 特定于商店的商品 ID，覆盖原生商店的`uSKU`。**store** (string, required): 此覆盖应用于的商店。`apple` 或 `google` 之一。**value** (string, required): The store-specific product identifier.

## 目录示例##example-catalog

以下目录列表包含基础目录字段和网上商店扩展字段。价格以微单位表示，其中 1,000,000 是货币的一个单位。

```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":"Best value", "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（后台）中管理您的目录](./dashboard-catalog/_index.md)。