管理者ポータルでインベントリ設定を作成および管理する

Last updated on October 19, 2026

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

警告

Inventory サービスは利用可能ですが、本番環境での使用はまだ推奨されていません。自由にお試しいただけますが、今後のアップデートで破壊的変更が導入される可能性があることにご注意ください。代替手段として、以下を検討してください。

• Entitlement: プレイヤーのアイテムを管理するための主要なオプションとして推奨されます。
• Extend: Entitlement でニーズを完全にカバーできない場合は、Extend を使用してカスタムソリューションを構築することを検討してください。

はじめに

In the AccelByte Gaming Services (AGS) Inventory service, an inventory configuration contains a set of information and rules to determine the type of inventory that your players can use in-game.

この記事では、AGS 管理者ポータルまたは AGS CLI を使用して、インベントリ設定を作成、更新、削除する方法について説明します。

前提条件

• Access to the AGS Admin Portal.
• A publisher or a game namespace.
• You have reviewed the key concepts of the Inventory service and the Inventory service API documentation.

• AGS CLI の手順に従う場合は、AGS CLI をインストールし、インベントリ設定を管理する権限を持つアカウントでサインインしてください。詳細については、インストールとサインインを参照してください。例では Bash シェルを使用しています。

インベントリ設定を表示する

Admin Portal

1. AGS 管理者ポータルのサイドバーで、Online > Inventory > Configurations に移動します。Inventory Configurations ページが表示されます。
2. インベントリ設定の一覧から、表示したい設定を見つけます。インベントリはコードで検索できます。設定のコードをクリックすると、詳細ページが開きます。

AGS CLI

1. ネームスペース内のインベントリ設定を一覧表示します。コードで検索する場合は、--code <InventoryCode> を追加します。<YourNamespace> はお使いのネームスペースに置き換えてください。

   ags inventory inventory-definitions list --namespace <YourNamespace>

2. 特定の設定を表示するには、一覧で確認した設定の id を指定します。

   ags inventory inventory-definitions get --namespace <YourNamespace> --inventory-configuration-id <InventoryConfigurationId>

インベントリ設定を作成する

Admin Portal

1. Inventory Configurations ページで、Create Configuration ボタンをクリックします。Create Configuration フォームが表示されます。

2. フォームに必要な情報を入力します。

   • Inventory Code: インベントリの ID を入力します。
   • Inventory Name: インベントリの名前を入力します。
   • Initial Slots: プレイヤーがアイテムの保管に使用できるスロットの最大数を設定するか、Set as Unlimited チェックボックスをオンにして無制限に設定します。各スロットには、スタックできないアイテムを 1 つ、または同一のアイテムを 1 つにまとめて (スタックして) 複数保管できます。
   • Maximum Slots Upgrade: プレイヤーがインベントリでアップグレードできるスロットの最大数を設定するか、Set as Unlimited チェックボックスをオンにして無制限に設定します。
   • Maximum Ownership: プレイヤー 1 人が所有できるこのインベントリの最大数を設定します。
   • Description: インベントリ設定の簡単な説明や追加情報を入力します。
   注記

   Initial Slots を Unlimited に設定すると、Maximum Slots Upgrade も自動的に Unlimited に設定されます。

3. Create をクリックします。新しいインベントリが Inventory Configurations リストに追加されます。

AGS CLI

1. 設定内容を記述した JSON ファイルを作成します。ファイル名は任意ですが、この例では inventory-config.json を使用します。

   {
     "code": "<InventoryCode>",
     "name": "<InventoryName>",
     "initialMaxSlots": 10,
     "maxUpgradeSlots": 25,
     "maxInstancesPerUser": 1,
     "description": "<Description>"
   }

   管理者ポータルのフィールド	リクエストボディのフィールド
   Inventory Code	code
   Inventory Name	name
   Initial Slots	initialMaxSlots
   Maximum Slots Upgrade	maxUpgradeSlots
   Maximum Ownership	maxInstancesPerUser
   Description	description

   スロットのフィールドを無制限にするには、値を -1 に設定します (管理者ポータルで Set as Unlimited をオンにするのと同じです)。initialMaxSlots を -1 に設定する場合は、管理者ポータルと同様に maxUpgradeSlots も -1 に設定してください。

2. 設定を作成します。JSON ファイルのパスは @ の後に指定します。

   ags inventory inventory-definitions create --namespace <YourNamespace> --json @inventory-config.json

インベントリ設定を更新する

インベントリ設定のステータスが INIT の場合は、すべての詳細を更新または編集できます。ステータスが TIED の場合は、Inventory Name と Description のみ更新できます。

インベントリ設定を更新するには、次の手順に従います。

Admin Portal

1. AGS 管理者ポータルのサイドバーで、Online > Inventory > Configurations に移動します。Inventory Configurations ページが表示されます。
2. インベントリ設定の一覧から、更新したい設定を見つけます。インベントリはコードで検索できます。設定のコードをクリックすると、詳細ページが開きます。
3. フィールドの値を編集するには、そのフィールドの編集 (鉛筆) アイコンをクリックします。値を編集したら、チェックボタンをクリックして変更を保存します。

AGS CLI

1. 設定の現在の内容をファイルに保存します。

   ags inventory inventory-definitions get --namespace <YourNamespace> --inventory-configuration-id <InventoryConfigurationId> --format json > inventory-config.json

2. inventory-config.json で変更したい値を編集します。その他のフィールドはそのままにしてください。

3. ファイルを送信します。

   ags inventory inventory-definitions update --namespace <YourNamespace> --inventory-configuration-id <InventoryConfigurationId> --json @inventory-config.json

   警告

   更新では設定全体が置き換えられます。省略したフィールドは、name、description、スロットのフィールドも含めてすべてクリアされます。必ず保存したファイルを基に編集してください。

インベントリ設定を削除する

インベントリ設定は、ステータスが INIT の場合のみ削除できます。ステータスが TIED のインベントリ設定は削除できません。

インベントリ設定を削除するには、次の手順に従います。

Admin Portal

1. AGS 管理者ポータルのサイドバーで、Online > Inventory > Configurations に移動します。Inventory Configurations ページが表示されます。
2. インベントリ設定の一覧から、削除したい設定を見つけます。インベントリはコードで検索できます。設定のコードをクリックすると、詳細ページが開きます。
3. 設定の詳細ページで Delete Configuration ボタンをクリックし、OK をクリックしてインベントリを削除します。インベントリは Inventory Configurations ページから直ちに削除されます。

AGS CLI

1. 削除したい設定の id を確認します。

   ags inventory inventory-definitions list --namespace <YourNamespace>

2. 設定を削除します。

   ags inventory inventory-definitions delete --namespace <YourNamespace> --inventory-configuration-id <InventoryConfigurationId>