管理者ポータルからプレイヤーインベントリを管理する

Last updated on October 19, 2026

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

警告

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

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

概要

This article walks you through how to grant, update, and delete the inventories of your players using the AccelByte Gaming Services (AGS) Admin Portal.

各タスクは 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 > Lookup Inventory に移動します。Lookup Inventory ページが表示されます。
2. インベントリの一覧から、表示したいインベントリを探します。プレイヤーの ID でインベントリを検索できます。インベントリのユーザー ID をクリックすると、詳細ページが開きます。

AGS CLI

1. プレイヤーのインベントリを一覧表示します。<YourNamespace> を自分の名前空間に、<UserId> をプレイヤーのユーザー ID に置き換えます。名前空間内のすべてのインベントリを一覧表示するには、--user-id を省略します。

   ags inventory inventories list --namespace <YourNamespace> --user-id <UserId>

2. 特定のインベントリを表示するには、一覧で取得したインベントリの id を指定します。

   ags inventory inventories get --namespace <YourNamespace> --inventory-id <InventoryId>

プレイヤーにインベントリを付与する

Admin Portal

1. Lookup Inventory ページのインベントリ一覧で、+ Grant Inventory ボタンをクリックします。Grant Inventory フォームが表示されます。

2. フォームで、インベントリを付与するユーザーをユーザー ID で検索し、Add をクリックします。

3. Inventory ドロップダウンで、プレイヤーに付与するインベントリを選択します。

4. Grant をクリックします。インベントリがプレイヤーに付与されます。

AGS CLI

インベントリを付与します。<UserId> をプレイヤーのユーザー ID に、<InventoryCode> をインベントリ設定のコードに置き換えます。コードは ags inventory inventory-definitions list --namespace <YourNamespace> を実行して確認できます。

ags inventory inventories create --namespace <YourNamespace> \
  --json '{"userId": "<UserId>", "inventoryConfigurationCode": "<InventoryCode>"}'

プレイヤーのインベントリのスロット上限を更新する

プレイヤーのインベントリのスロット上限を更新するには、次の手順に従います。

Admin Portal

1. Lookup Inventory ページのインベントリ一覧で、スロット上限を更新するインベントリを持つプレイヤーを探し、そのユーザー ID をクリックして詳細ページに移動します。

2. プレイヤーの詳細ページで、Inventory Slot フィールドの編集 (鉛筆) アイコンをクリックして値を編集します。値の編集には次の条件があります。

   • プレイヤーに付与されたインベントリ設定で定められた上限の範囲内で、プレイヤーのスロット上限を増減できます。たとえば、プレイヤーのインベントリ設定のスロットアップグレード上限が 25 の場合、25 を超える値は無効となるため、25 以下の値のみ指定できます。インベントリ設定のスロットアップグレード上限の設定については、Create and manage inventory configuration を参照してください。
   • プレイヤーに付与されたインベントリ設定のスロットアップグレード上限が無制限の場合、値は編集できません。

3. チェックボタンをクリックして変更を保存します。

AGS CLI

1. インベントリの現在のスロット上限（maxSlots）を確認します。

   ags inventory inventories get --namespace <YourNamespace> --inventory-id <InventoryId>

2. スロット上限を変更します。incMaxSlots には新しい上限値ではなく、増やすスロット数を指定します。スロットを減らすには負の数を使用します。たとえば、スロット数を 10 から 15 にするには 5 を指定します。新しい上限はインベントリ設定のスロットアップグレード上限を超えることはできず、スロットアップグレードが無制限のインベントリは編集できません。

   ags inventory inventories update --namespace <YourNamespace> --inventory-id <InventoryId> \
     --json '{"incMaxSlots": 5}'

プレイヤーのインベントリを削除する

プレイヤーインベントリは、空の場合にのみ削除できます。インベントリを削除する前に、プレイヤーのインベントリからすべてのアイテムを取り除いてください。

プレイヤーのインベントリを削除するには、次の手順に従います。

Admin Portal

1. Lookup Inventory ページのインベントリ一覧で、削除するインベントリを持つプレイヤーを探し、そのユーザー ID をクリックして詳細ページに移動します。
2. プレイヤーの詳細ページで、Basic Information テーブルの下部にある Delete inventory ボタンをクリックし、ポップアップで OK をクリックします。プレイヤーのインベントリが削除されます。

AGS CLI

インベントリを削除します。message は必須項目で、削除理由などのメモを指定します。AGS はこのメモを削除記録とともに保存します。

ags inventory inventories delete --namespace <YourNamespace> --inventory-id <InventoryId> \
  --json '{"message": "<DeletionReason>"}'