Webshop 目录架构参考
查找可用于控制商品在 Webshop 中的显示方式的目录字段。
网上商店会在项目的 IAP 目录中渲染商品。每个商品都是标准的 IAP 目录商品，您可以使用特定于网上商店的字段（类别、高分辨率图像、推荐处理、展示顺序和每个商品标示）进行扩展，从而控制商品在商店中的显示方式。
此参考列出了网上商店为每个商品读取的字段：每个 IAP 商品的基本目录字段以及网上商店扩展字段。Webshop 扩展字段仅适用于包含在 Webshop 目录中的商品。有关目录的来源和商品展示方式的信息，请参阅目录和网上商店付款；要创作商品，请参阅在 Editor 中创建目录。
商品字段
这些是每个目录商品的基字段。
字段 | Type（类型） | 必需 | 描述 |
|---|
| 字符串 | 是 | 商品的唯一标识符 (SKU)。 |
| 字符串 | 是 | 商品类型：、 或 。 |
| 字符串 | 否 | 商品卡上显示的商品图像的 URL。 |
| 数组 | 是 | 本地化显示详细信息，每种语言一个条目。请参阅本地化产品详细信息。 |
| 数组 | 是 | 每种货币的价格。请参阅定价。 |
| 数组 | 否 | 替换特定于商店的商品 ID。每个条目都有一个（或）和一个。 |
本地化产品详细信息
中的每个条目都以一种语言描述商品。
字段 | Type（类型） | 必需 | 描述 |
|---|
| 字符串 | 是 | 此条目适用的语言。 |
| 字符串 | 是 | 商品的显示名称。 |
| 字符串 | 是 | 面向玩家的商品描述。 |
| 字符串 | 否 | 随标题一起显示的可选辅助行。 |
| 对象 | 否 | 产品卡上显示的芯片。包含（必填，最多 32 个字符）和文本旁边显示的图标的可选。任何商品都可以带有标示，无论是否在销售中。 |
定价
中的每个条目都以一种货币设置价格。数组必须在 中至少包含一个条目。
字段 | Type（类型） | 必需 | 描述 |
|---|
| 字符串 | 是 | ISO 4217 货币代码，例如 或 。 |
| 整数 | 是 | 为商品收取的金额。 |
| 整数 | 否 | 网上商店上显示的价格。设置此选项可为商品提供特定于 Web 的价格。 |
Webshop 扩展字段
这些字段使用特定于 Webshop 的显示选项扩展基础目录商品。它们仅对您的网上商店目录中的商品生效。
字段 | Type（类型） | 必需 | 描述 |
|---|
| 字符串数组 | 否 | 商品所属的类别 ID（最多 16 个，唯一）。每个类别都必须与您为网上商店定义的类别相匹配。 |
| 数组 | 否 | 商品详细信息对话框的高分辨率图像（最多 8 张）。每个条目都有一个（必填）和一个可选。 |
| 对象 | 否 | 卡的推荐处理。 为 、 或 。可选的 和 字段 (RFC 3339 date-times) 可调度显示治疗的时间。 |
| 整数 | 否 | 商品在商店中的展示顺序。较低的值首先出现。 |
示例
以下商品同时包含基础目录字段和网上商店扩展字段：
{ "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}