ストアアイテムを作成する

Last updated on October 9, 2026

注釈：本資料はAI技術を用いて翻訳されています。

概要

この記事では、ストアで販売するアイテムを作成する方法について説明します。

新しいアイテムはドラフトストアでのみ作成できます。パブリッシュされたストアのアイテムは変更できません。

アイテムは、AGS 管理者ポータルまたは AGS CLI で作成できます。

前提条件

• AGS管理者ポータルへのアクセス権があること。
• ゲームまたはパブリッシャーの名前空間があること。
• アイテムカテゴリを含む既存のドラフトストアがあること。

• AGS CLI の手順に従うには、AGS CLI をインストールし、これらの機能へのアクセス権を持つアカウントでサインインしていること。インストールとサインインを参照してください。例では Bash シェルを使用します。

アイテムタイプ

以下のアイテムを作成できます。

アイテム	説明	適用可能な名前空間
In-Game Item:	プレイヤーがゲーム内で使用する耐久性または消耗性のアイテム。ゲーム内アイテムを作成する前に、ストアにGameタイプのAppを登録する必要があります。	Publisher、Game
Bundle	ストアの1つ以上のアイテムを1つの購入可能なアイテムにまとめたパッケージ。バンドルを作成するには、少なくとも2つのアイテムを作成する必要があります。	Publisher、Game
Coin	プレイヤーの仮想通貨ウォレットにチャージするために使用できるクレジット。	Publisher、Game
Code	プレイヤーがアプリ、ゲーム内アイテム、バンドルなどを引き換えるために使用します。	Publisher、Game
Media	音楽、限定アートなどのアイテム。	Publisher、Game
Option Box	他のアイテムのリストが含まれています。プレイヤーはオプションボックスを開くときに1つのアイテムを選択して保持できます。	Publisher、Game
Loot Box	ルートボックスが開かれたときに表示される個別の確率を持つ他のアイテムのリストが含まれています。	Publisher、Game
Extension	カスタムサービスと共に使用して、プレイヤーがカスタムアイテムを購入できるようにします。Extensionは現在、APIを介してのみ作成できます。	Publisher、Game
App	ゲーム、デモ、DLCなどのアプリケーションアイテムに使用されます。	Game
Subscription	サブスクリプションパッケージを作成するために使用されます。	Publisher
Season	パスとティアを使用して参加プレイヤーを引き付ける期間限定イベント。	Publisher

ストアアイテムを作成する

Admin Portal

App

1. 管理者ポータルのサイドバーで、Online > Store & Catalog > Storesに移動します。Storesページが表示されます。

2. ドラフトストアのViewボタンをクリックします。Draft Storesページが表示されます。

3. + Create Itemボタンをクリックします。「Create Item」フォームが表示されます。

4. 次のように必要な情報を入力します。

   Basic Information

   • Item Type: Appを選択します。
   • Item Name: アイテムの名前を入力します。
   • Category: アイテムに適用可能なカテゴリを選択します。
   • App Type: Appのタイプを選択します：Demo、DLC、Game、またはSoftware。
   • App ID: これは英数字で構成される一意の識別子で、アップロード時にゲームを識別するために使用されます。App IDは定義後に変更できないことに注意してください。

   Store Configuration

   • SKU Number: アイテムにSKU番号を割り当てます。

   • Item Purchase Limit: ストアでのこのアイテムの購入制限を定義します。例えば、アイテムの購入制限を100に設定すると、その特定のアイテムの100ユニットがストアで購入可能になります。この値を無制限にするには、-1を使用します。

   • Entitlement Type: これはデフォルトでDurableに設定されています。

   • Store Display Order: Player Portalのアイテムリストの中でアイテムが表示される順序を設定します。

   • Display Order: Player Portalのアイテムリストの中でアイテムが表示される順序を設定します。

   • Visible in StoreとPurchasable in Store

     • Visible in Store: アイテムを表示する場合はTrueを選択し、パブリッシュされたストアからアイテムを非表示にする場合はFalseを選択します。
     • Purchasable in Store: アイテムを購入可能にする場合はTrueを選択し、購入不可にする場合はFalseを選択します。

   これら2つのオプションは一緒に設定され、次のシナリオで設定できます。

   • ストアですぐに購入可能にしたいアイテムの場合は、Visible in StoreとPurchasable in Storeの両方でTrueを選択します。

   • プレイヤーにアイテムのプレビューを提供したいが、アイテムは後で利用可能になる場合は、Visible in StoreでTrue、Purchasable in StoreでFalseを選択します。

   • 後で作業できるドラフトとしてアイテムを保存する場合は、Visible in StoreでFalse、Purchasable in StoreでTrueを選択します。

   • Features: このフィールドはタグのように機能します。このフィールドを使用して、アイテムの機能を含めます。例：Christmas Special Edition、Summer Beach、Blinky Mushroom Eraなど。各アイテムは複数の機能を持つことができます。そのため、アイテムは割り当てられた機能に基づいて自由にグループ化できます。このフィールドはオプションです。

   • Extension: このフィールドを使用して、カスタム使用のためにアイテムに追加情報を追加します。これは有効なJSON形式で記述する必要があります。例えば、色、攻撃力などの特別な属性をextensionを使用して定義できます。オブジェクトの配列は許可されていません。

5. Createをクリックします。Appアイテムが選択したカテゴリの下のドラフトストアに作成されます。

Coin

1. 管理者ポータルのサイドバーで、Online > Store & Catalog > Storesに移動します。Storesページが表示されます。

2. ドラフトストアのViewボタンをクリックします。Draft Storesページが表示されます。

3. + Create Itemボタンをクリックします。「Create Item」フォームが表示されます。

4. 次のように必要な情報を入力します。

   Basic Information

   • Item Type: Coinを選択します。
   • Item Name: アイテムの名前を入力します。
   • Category: アイテムに適用可能なカテゴリを選択します。
   • Currency Code: アイテムに関連付けられたコインの通貨コード。

   Store Configuration

   • SKU Number: アイテムにSKU番号を割り当てます。

   • Item Purchase Limit: ストアでのこのアイテムの購入制限を定義します。例えば、アイテムの購入制限を100に設定すると、その特定のアイテムの100ユニットがストアで購入可能になります。この値を無制限にするには、-1を使用します。

   • User Purchase Limit: 各アカウントのこのアイテムの購入制限を定義します。例えば、このアイテムのユーザー購入制限を100に設定すると、各アカウントに対して、その特定のアイテムの100ユニットがストアで購入可能になります。この値を無制限にするには、-1を使用します。

   • Entitlement Type: これはデフォルトでConsumableに設定されています。

   • Item Use Count: このアイテムを使用できる回数を定義します。

   • Stack Entitlement: アイテムをスタック可能にする場合はTrueに設定します。そうでない場合はFalseに設定します。

   • Store Display Order: Player Portalのアイテムリストの中でアイテムが表示される順序を設定します。

   • Visible in StoreとPurchasable in Store

     • Visible in Store: アイテムを表示する場合はTrueを選択し、パブリッシュされたストアからアイテムを非表示にする場合はFalseを選択します。
     • Purchasable in Store: アイテムを購入可能にする場合はTrueを選択し、購入不可にする場合はFalseを選択します。

   これら2つのオプションは一緒に設定され、次のシナリオで設定できます。

   • ストアですぐに購入可能にしたいアイテムの場合は、Visible in StoreとPurchasable in Storeの両方でTrueを選択します。

   • プレイヤーにアイテムのプレビューを提供したいが、アイテムは後で利用可能になる場合は、Visible in StoreでTrue、Purchasable in StoreでFalseを選択します。

   • 後で作業できるドラフトとしてアイテムを保存する場合は、Visible in StoreでFalse、Purchasable in StoreでTrueを選択します。

   • Section Exclusive: アイテムをセクションに割り当てられたときにのみ販売したい場合は、トグルをActiveにします。

   • Features: このフィールドはタグのように機能します。このフィールドを使用して、アイテムの機能を含めます。例：Christmas Special Edition、Summer Beach、Blinky Mushroom Eraなど。各アイテムは複数の機能を持つことができます。そのため、アイテムは割り当てられた機能に基づいて自由にグループ化できます。このフィールドはオプションです。

   • Extension: このフィールドを使用して、カスタム使用のためにアイテムに追加情報を追加します。これは有効なJSON形式で記述する必要があります。例えば、色、攻撃力などの特別な属性をextensionを使用して定義できます。オブジェクトの配列は許可されていません。

   Pricing Configuration

   • Currency namespace: 通貨のソース。
   • Currency Code: アイテムの購入に使用される通貨コード。
   • Default price: アイテムを無料にする場合は、価格を0に設定します。実際の通貨で価格を設定する場合は、最後の2桁を小数として設定します。つまり、通貨シンボルとして$を選択した場合、1.99と設定すると、ストアでアイテムが$1.99に設定されます。

5. Createをクリックします。アイテムが選択したカテゴリの下のドラフトストアに作成されます。

Subscription

1. 管理者ポータルのサイドバーで、Online > Store & Catalog > Storesに移動します。Storesページが表示されます。

2. ドラフトストアのViewボタンをクリックします。Draft Storesページが表示されます。

3. + Create Itemボタンをクリックします。「Create Item」フォームが表示されます。

4. 次のように必要な情報を入力します。

   Basic Information

   • Item Type: Subscriptionを選択します。
   • Item Name: アイテムの名前を入力します。
   • Category: アイテムに適用可能なカテゴリを選択します。

   Store Configuration

   • SKU Number: アイテムにSKU番号を割り当てます。

   • Entitlement Type: これはデフォルトでDurableに設定されています。

   • Visible in StoreとPurchasable in Store

     • Visible in Store: アイテムを表示する場合はTrueを選択し、パブリッシュされたストアからアイテムを非表示にする場合はFalseを選択します。
     • Purchasable in Store: アイテムを購入可能にする場合はTrueを選択し、購入不可にする場合はFalseを選択します。

   これら2つのオプションは一緒に設定され、次のシナリオで設定できます。

   • ストアですぐに購入可能にしたいアイテムの場合は、Visible in StoreとPurchasable in Storeの両方でTrueを選択します。
   • プレイヤーにアイテムのプレビューを提供したいが、アイテムは後で利用可能になる場合は、Visible in StoreでTrue、Purchasable in StoreでFalseを選択します。
   • 後で作業できるドラフトとしてアイテムを保存する場合は、Visible in StoreでFalse、Purchasable in StoreでTrueを選択します。
   • Features: このフィールドはタグのように機能します。このフィールドを使用して、アイテムの機能を含めます。例：Christmas Special Edition、Summer Beach、Blinky Mushroom Eraなど。各アイテムは複数の機能を持つことができます。そのため、アイテムは割り当てられた機能に基づいて自由にグループ化できます。このフィールドはオプションです。
   • Extension: このフィールドを使用して、カスタム使用のためにアイテムに追加情報を追加します。これは有効なJSON形式で記述する必要があります。例えば、色、攻撃力などの特別な属性をextensionを使用して定義できます。オブジェクトの配列は許可されていません。

   Pricing Configuration

   • Currency namespace: 通貨のソース。
   • Currency Code: アイテムの購入に使用される通貨コード。
   • Default price: アイテムを無料にする場合は、価格を0に設定します。実際の通貨で価格を設定する場合は、最後の2桁を小数として設定します。例えば、通貨シンボルとして$を選択した場合、1.99と設定すると、ストアでアイテムが$1.99に設定されます。

   Subscription Configuration

   • Billing Cycle: サブスクライブしているプレイヤーに請求する頻度を定義します。ユーザーにWeekly、Monthly、Quarterly、またはYearlyで請求することを選択できます。
   • Grace Period: 支払い処理の問題が発生した場合に、プレイヤーに支払いのための追加時間を与えます。デフォルト設定は7日間です。
   • Trial Plan: Free Trial、Paid Trial、またはNo Trialから選択します。
     • Free Trialを選択した場合は、Trial Period Lengthを日数で設定します。
     • Paid Trialを選択した場合は、Trial Period Lengthを請求サイクル単位で設定し、Trial Priceを設定します。

5. Createをクリックします。アイテムが選択したカテゴリの下のドラフトストアに作成されます。

Option Box

1. 管理者ポータルのサイドバーで、Online > Store & Catalog > Storesに移動します。Storesページが表示されます。

2. ドラフトストアのViewボタンをクリックします。Draft Storesページが表示されます。

3. + Create Itemボタンをクリックします。「Create Item」フォームが表示されます。

4. 次のように必要な情報を入力します。

   Basic Information

   • Item Type: Option boxを選択します。
   • Item Name: アイテムの名前を入力します。
   • Category: アイテムに適用可能なカテゴリを選択します。
   • Currency Code: アイテムに関連付けられたコインの通貨コード。

   Store Configuration

   • SKU Number: アイテムにSKU番号を割り当てます。

   • Item Purchase Limit: ストアでのこのアイテムの購入制限を定義します。例えば、アイテムの購入制限を100に設定すると、その特定のアイテムの100ユニットがストアで購入可能になります。この値を無制限にするには、-1を使用します。

   • User Purchase Limit: 各アカウントのこのアイテムの購入制限を定義します。例えば、このアイテムのユーザー購入制限を100に設定すると、各アカウントに対して、その特定のアイテムの100ユニットがストアで購入可能になります。この値を無制限にするには、-1を使用します。

   • Entitlement Type: これはデフォルトでConsumableに設定されています。

   • Item Use Count: このアイテムを使用できる回数を定義します。

   • Stack Entitlement: アイテムをスタック可能にする場合はTrueに設定します。そうでない場合はFalseに設定します。

   • Store Display Order: Player Portalのアイテムリストの中でアイテムが表示される順序を設定します。

   • Visible in StoreとPurchasable in Store

     • Visible in Store: アイテムを表示する場合はTrueを選択し、パブリッシュされたストアからアイテムを非表示にする場合はFalseを選択します。
     • Purchasable in Store: アイテムを購入可能にする場合はTrueを選択し、購入不可にする場合はFalseを選択します。

   これら2つのオプションは一緒に設定され、次のシナリオで設定できます。

   • ストアですぐに購入可能にしたいアイテムの場合は、Visible in StoreとPurchasable in Storeの両方でTrueを選択します。

   • プレイヤーにアイテムのプレビューを提供したいが、アイテムは後で利用可能になる場合は、Visible in StoreでTrue、Purchasable in StoreでFalseを選択します。

   • 後で作業できるドラフトとしてアイテムを保存する場合は、Visible in StoreでFalse、Purchasable in StoreでTrueを選択します。

   • Section Exclusive: アイテムをセクションに割り当てられたときにのみ販売したい場合は、トグルをActiveにします。

   • Features: このフィールドはタグのように機能します。このフィールドを使用して、アイテムの機能を含めます。例：Christmas Special Edition、Summer Beach、Blinky Mushroom Eraなど。各アイテムは複数の機能を持つことができます。そのため、アイテムは割り当てられた機能に基づいて自由にグループ化できます。このフィールドはオプションです。

   • Extension: このフィールドを使用して、カスタム使用のためにアイテムに追加情報を追加します。これは有効なJSON形式で記述する必要があります。例えば、色、攻撃力などの特別な属性をextensionを使用して定義できます。オブジェクトの配列は許可されていません。

   Pricing Configuration

   • Currency namespace: 通貨のソース。
   • Currency Code: アイテムの購入に使用される通貨コード。
   • Default price: アイテムを無料にする場合は、価格を0に設定します。実際の通貨で価格を設定する場合は、最後の2桁を小数として設定します。つまり、通貨シンボルとして$を選択した場合、1.99と設定すると、ストアでアイテムが$1.99に設定されます。

5. Nextをクリックして、Add Itemsセクションに移動します。

6. +Add Itemsボタンをクリックし、次の手順に従ってオプションボックスへのアイテムの追加を開始します。オプションボックスには、既存のゲーム内アイテム、コイン、およびアプリアイテムのみを追加できることに注意してください。

   1. Type: 追加するアイテムの対応するタイプを選択します。
   2. Item Name: アイテムの名前を入力して検索します。
   3. Quantity: オプションボックスに追加されるアイテムの数量を設定します。
   4. Ownership Period: 所有権を次のいずれかに設定できます。
      • Permanent: プレイヤーに永続的な所有権を設定します。
      • Duration: プレイヤーがアイテムを所有できる日数を設定します。
      • Expiration date: プレイヤーのアイテム所有権の有効期限を設定します。

7. オプションボックスにさらにアイテムを追加するには、+ Add More Itemsをクリックします。

8. アイテムを追加した後、Saveをクリックします。オプションボックスに追加したアイテムのリストが表示されます。

9. Createをクリックして、オプションボックスアイテムの作成を完了します。

AGS CLI

1. ドラフトストアの ID を確認します。出力のうち、published が false のストアの storeId がドラフトストアの ID です。あわせて defaultLanguage と defaultRegion もメモしておきます。

   ags platform stores list --namespace <YourNamespace> --format json

2. アイテムのカテゴリの categoryPath を確認します。

   ags platform categories list --namespace <YourNamespace> --store-id <StoreId> --format json

3. アイテムの設定を記述した JSON ファイルを作成します。ファイル名は任意です。この例では item.json を使用します。アイテムタイプに応じた内容を使用してください。

   App

   {
     "itemType": "APP",
     "name": "<ItemName>",
     "categoryPath": "<CategoryPath>",
     "appType": "GAME",
     "appId": "<AppId>",
     "sku": "<SkuNumber>",
     "entitlementType": "DURABLE",
     "localizations": {
       "<DefaultLanguage>": { "title": "<ItemName>" }
     },
     "regionData": {
       "<DefaultRegion>": [
         { "currencyNamespace": "<CurrencyNamespace>", "currencyCode": "<CurrencyCode>", "price": 199 }
       ]
     }
   }

   • appType: DEMO、DLC、GAME、または SOFTWARE。
   • appId: アプリの App ID。アイテムの作成後は変更できません。

   Coin

   {
     "itemType": "COINS",
     "name": "<ItemName>",
     "categoryPath": "<CategoryPath>",
     "targetCurrencyCode": "<CoinCurrencyCode>",
     "sku": "<SkuNumber>",
     "entitlementType": "CONSUMABLE",
     "useCount": 1,
     "localizations": {
       "<DefaultLanguage>": { "title": "<ItemName>" }
     },
     "regionData": {
       "<DefaultRegion>": [
         { "currencyNamespace": "<CurrencyNamespace>", "currencyCode": "<CurrencyCode>", "price": 199 }
       ]
     }
   }

   • targetCurrencyCode: Basic Information の Currency Code で、コインの通貨です。
   • useCount: Item Use Count。1 以上である必要があります。

   Subscription

   {
     "itemType": "SUBSCRIPTION",
     "name": "<ItemName>",
     "categoryPath": "<CategoryPath>",
     "sku": "<SkuNumber>",
     "entitlementType": "DURABLE",
     "recurring": {
       "cycle": "MONTHLY",
       "graceDays": 7,
       "fixedFreeDays": 0,
       "fixedTrialCycles": 0
     },
     "localizations": {
       "<DefaultLanguage>": { "title": "<ItemName>" }
     },
     "regionData": {
       "<DefaultRegion>": [
         { "currencyNamespace": "<CurrencyNamespace>", "currencyCode": "<CurrencyCode>", "price": 999 }
       ]
     }
   }

   • cycle: Billing Cycle。WEEKLY、MONTHLY、QUARTERLY、または YEARLY。
   • graceDays: Grace Period (日数)。
   • Trial Plan: 無料トライアルの場合は、fixedFreeDays にトライアル期間を日数で設定します。有料トライアルの場合は、fixedTrialCycles にトライアル期間を請求サイクル単位で設定し、regionData の price の隣に trialPrice を追加します。トライアルなしの場合は、両方とも 0 のままにします。

   Option Box

   {
     "itemType": "OPTIONBOX",
     "name": "<ItemName>",
     "categoryPath": "<CategoryPath>",
     "sku": "<SkuNumber>",
     "entitlementType": "CONSUMABLE",
     "useCount": 1,
     "optionBoxConfig": {
       "boxItems": [
         { "itemId": "<FirstItemId>", "count": 1 },
         { "itemId": "<SecondItemId>", "count": 1 }
       ]
     },
     "localizations": {
       "<DefaultLanguage>": { "title": "<ItemName>" }
     },
     "regionData": {
       "<DefaultRegion>": [
         { "currencyNamespace": "<CurrencyNamespace>", "currencyCode": "<CurrencyCode>", "price": 199 }
       ]
     }
   }

   • boxItems: オプションボックス内のアイテム。名前からアイテムの itemId を確認するには、ags platform items list --namespace <YourNamespace> --store-id <StoreId> --item-name '<BoxItemName>' --format json を実行します。count は Quantity です。
   • Ownership Period: 永続的な所有権の場合は省略します。ボックス内のコインアイテムについては、そのエントリに duration (秒単位) または endDate を追加できますが、両方は追加できません。

   すべてのアイテムタイプに共通する設定は次のとおりです。

   • localizations: <DefaultLanguage> をストアの defaultLanguage に置き換えます。アイテムにはストアのデフォルト言語のタイトルが必要です。
   • regionData: <DefaultRegion> をストアの defaultRegion に置き換えます。アイテムにはストアのデフォルトリージョンの価格が必要です。
   • currencyNamespace: 自分の名前空間またはパブリッシャー名前空間。名前空間内の通貨を確認するには、ags platform currencies list --namespace <CurrencyNamespace> --format json を実行します。
   • price: 整数で指定します。末尾の桁（通貨の decimals で指定された桁数）が小数部分として扱われます。例えば、小数点以下2桁の通貨では、199 は 1.99 です。アイテムを無料にするには 0 を使用します。

   その他のフィールドを設定する場合は、ファイルに追加してください。すべてのフィールドを確認するには、ags platform items create --skeleton を実行します。以下のフィールドは管理者ポータルの設定に対応しています。

   管理者ポータルの設定	リクエストボディのフィールド
   Item Purchase Limit	maxCount。制限なしの場合は省略します。
   User Purchase Limit	maxCountPerUser。制限なしの場合は省略します。
   Item Use Count	useCount
   Stack Entitlement	stackable
   Store Display Order	displayOrder
   Visible in Store	listable
   Purchasable in Store	purchasable
   Section Exclusive	sectionExclusive
   Features	features
   Extension	ext

4. アイテムを作成します。@ の後に JSON ファイルのパスを指定します。

   ags platform items create --namespace <YourNamespace> --store-id <StoreId> --json @item.json

   コマンドが成功すると、作成されたアイテムが出力されます。

次のステップ

ストアのアイテムを作成した後、ストアのパブリッシュに進むことができます。ストアをパブリッシュするの記事の手順に従ってください。