文档

应用内购

IAP 客户端 API

IAP SDK API

Webshop Admin API

Webshop Client API

应用内购

目录架构

查找可用于在目录中定义列表的字段，包括本地化内容、定价和网上商店展示元数据。
阅读时间4 分钟最后更新于 3 个月前
目录架构定义了 IAP 目录中目录列表的结构。每个列表描述了其核心标识、本地化显示内容、定价和可选的商店元数据。
并非所有字段都适用于每个列表。如果通过网上商店销售，可使用其他显示选项扩展列表。请参阅 Webshop 扩展字段。

列出架构

请参阅创建目录列表时可用的以下字段：

catalogListingId

string
必填
此列表的唯一标识符，与 
uSKU
不同。允许同一游戏内物品的唯一列表。

uSKU

string
必填
商品的唯一标识符 (SKU)。1–141 个字符，仅限于字母、数字以及
.
、
_
和
-
字符。

type

string
必填
商品类型。
Consumable
、
NonConsumable
或 
Subscription
之一。

imageUrl

string
列表标准图像资源的绝对 HTTPS URL。

productDetails

object[]
必填
列表的本地化内容，每种支持的语言有一个条目。必须至少包含一个条目。

language

string
必填
此条目的 BCP 47 语言标签（例如 
en-US
、
es-ES
）。

title

string
必填
本地化列表标题。最多 50 个字符。

subtitle

string
本地化列表子标题。最多 50 个字符。

description

string
向玩家显示的本地化列表描述。最多 250 个字符。

badge

object
列表上显示的推荐标示。

text

string
必填
标示标签文本（例如 
+125
、
25% OFF
）。

imageUrl

string
标示图像资源的绝对 HTTPS URL。

pricing

object[]
必填
每种支持货币的定价条目。必须至少包含一个条目，并且必须在 
USD
中包含条目。

currencyCode

string
必填
ISO 4217 货币代码（例如，
USD
、
EUR
）。

amount

integer
必填
为商品收取的金额，以微米为单位（1,000,000 micros = 1 个货币单位）。例如， 
9990000
为 9.99。必须大于 0。

webshopPrice

integer
网上商店上显示的价格（以微缩为单位）。设置此选项可为商品提供特定于 Web 的价格。

storeIdOverrides

object
特定于商店的商品 ID，覆盖原生商店的
uSKU
。

store

string
必填
此覆盖应用于的商店。
apple
或 
google
之一。

value

string
必填
The store-specific product identifier.

目录示例

以下目录列表包含基础目录字段和网上商店扩展字段。价格以微单位表示，其中 1,000,000 是货币的一个单位。
[  {    "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  }]

其他资源