ドキュメント

カタログスキーマ

ローカライズされたコンテンツ、価格、ウェブショップのディスプレイメタデータなど、カタログのリストを定義するために使用できるフィールドを見つけます。
読み終わるまでの所要時間 6 分最終更新 2ヶ月前

カタログスキーマは、IAP カタログ内のカタログリストの構造体を定義します。各リストには、そのコア ID、ローカライズされたディスプレイコンテンツ、価格、任意のストアメタデータが記載されています。
すべてのフィールドがすべてのリストに適用されるわけではありません。ウェブショップを通じて販売する場合は、追加のディスディスプレイでリスティングを拡張できます。Webshop 拡張子フィールドを参照してください。

スキーマのリスト

カタログリストの作成時に使用できる以下のフィールドを参照してください。

catalogListingId

string
必須
このリストの一意の識別子。
uSKU
とは異なります。同じゲーム内項目の一意のリストを許可します。

uSKU

string
必須
製品の一意の識別子 (SKU)。1 ~ 141 文字。文字、数字、および
.
_
-
文字に限定。

type

string
必須
プロダクトタイプ
Consumable
NonConsumable
、または
Subscription
のいずれか。

imageUrl

string
リストの標準画像アセットの絶対 HTTPS URL。

productDetails

object[]
必須
サポートされている言語ごとに 1 エントリーを持つ、リストのローカライズされたコンテンツ。少なくとも 1 つのエントリーが含まれている必要があります。

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[]
必須
サポートされている各通貨の価格エントリー。少なくとも 1 つのエントリーを含み、
USD
にエントリーを含める必要があります。

currencyCode

string
必須
ISO 4217 通貨コード (例えば、
USD
EUR
)。

amount

integer
必須
製品に対して課金される金額(マイクロ単位)(1,000,000 マイクロ = 1 単位通貨)例えば、
9990000
は 9.99 です。0 より大きくなければなりません。

webshopPrice

integer
ウェブショップに表示される価格 (マイクロ単位)。ウェブ固有の価格を設定する。

storeIdOverrides

object[]
ネイティブストアの
uSKU
をオーバーライドするストア固有のプロダクト ID。

store

string
必須
このオーバーライドが適用されるストア。
apple
または
google
のいずれか。

value

string
必須
The store-specific product identifier.

カタログの例

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

追加リソース