AGS コマースとのインベントリ統合を管理する

Last updated on February 4, 2026

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

注記

インベントリサービスはリクエストに応じて利用可能です。このサービスを環境に統合するには、AccelByte カスタマーサポートポータルからリクエストを開いてください。

概要​

AccelByte Gaming Service (AGS) インベントリサービスを使用すると、ストアとエンタイトルメントサービスのデータをプレイヤーが所有するアイテムの権威あるソースとして使用できます。この統合により、エンタイトルメントがプレイヤーが所有するアイテムの主要なデータソースとなり、インベントリサービスが、購入、消費、破棄、取引、贈答などのアイテムに対する重複または競合するアクションなどの問題を回避するのに役立ちます。

前提条件​

次のものへのアクセスが必要です。

  • AGS 管理者ポータル
  • AGS インベントリ API ドキュメント
  • AGS Unreal または Unity SDK。次の権限を含む：
    • Client ID
    • Client Secret

インベントリとコマースの同期動作​

サポートされているアイテムタイプ​

インベントリとコマースサービス間のシームレスな統合を確保するために、AGS はエンタイトルメントからインベントリへの特定のアイテムタイプの同期をサポートしています。サポートされているアイテムタイプは次のとおりです。

  • ゲーム内アイテム
  • ルートボックス
  • オプションボックス
  • バンドル
注記

バンドルアイテムの場合、ゲーム内アイテム、ルートボックス、オプションボックスのみがバンドルからプレイヤーインベントリに同期できます。バンドルの他のアイテムタイプは同期できません。

サポートされているアイテム属性​

インベントリサービスはデコレーターとして機能し、AGS ストアサービスに依存して定義されたアイテム属性を使用します。ストアからインベントリに同期できるサポートされている属性は、最初は基本的なデフォルト値を持ちます。一部の属性は、後でインベントリ内から変更できます。このアプローチにより、スムーズな初期設定が保証され、インベントリでのカスタマイズされたアイテム属性のカスタマイズが可能になり、柔軟性とアイテム固有のカスタマイズが向上します。

  • 例えば、Item Name、Description、Image は基本的なアイテム情報を表し、インベントリ内で個別に変更することはできません。これらは常にストアで設定された値に従います。
  • 一方、Custom Attributes、Server Custom Attributes、Slot Used などの他の属性は、インベントリのデフォルト値として機能しますが、後で更新または変更でき、ストアで設定されたデフォルト値に影響を与えることなく、個々のアイテムに対して特別に変更できます。この属性の詳細については、アイテムのカスタム属性を参照してください。

このアプローチにより、AGS ストアで設定されたデフォルト属性との一貫性と、インベントリサービス内での柔軟なカスタマイズの両方が保証されます。

プラットフォーム固有のアイテム​

インベントリサービスは、Xbox、PSN、Epic、Steam などのさまざまなプラットフォームから発信されるアイテムを区別します。これは、次の方法でサービスの動作に影響します。

  • インベントリは、それぞれのプラットフォームからのアイテムの取得のみを許可します（例：Steam から来たアイテムは Steam からのみ取得できます）。
  • インベントリは、単一のプラットフォームまたは複数のプラットフォームからのアイテムを同じユーザーインベントリ内に保存することをサポートし、すべてのプラットフォームにわたって容量を集合的に計算します。
    • 特定のプラットフォームからのアイテムを個別に保存したい場合は、そのプラットフォーム専用のインベントリ設定を作成できます（例：Steam Backpack）。
    • または、複数のプラットフォームからのアイテムを一緒に保存したい場合は、異なるプラットフォームから発信されるすべてのアイテム用の単一のインベントリ設定を作成できます（例：Backpack）。
注記

単一のインベントリを使用して複数のプラットフォームからのアイテムを保存すると、主に1つのプラットフォーム（例：Steam）から来るアイテムによってインベントリがいっぱいになり、他のプラットフォーム（例：Epic）からのアイテムに利用可能なストレージが制限される可能性があります。

サポートされているアクション​

インベントリとコマースの両方でサポートされているアクションは、相互接続された操作に大きな影響を与えます。これは、いずれかのシステムから発信されるアクションが他のシステムに影響を与える可能性があることを意味します。インベントリとコマースの両方からサポートされているアクションと、各システムの機能と相互作用を探りましょう。

アイテムの追加​

  1. コマースからアイテムを購入する。プレイヤーがコマースから購入したアイテムは、プレイヤーのインベントリに同期されます。プレイヤーのインベントリがいっぱいの場合、プレイヤーはコマースからさらにアイテムを購入できません。
  2. チャレンジ、シーズンパス、その他のソースからの報酬であるアイテムなど、他のエンタイトルメントソースからエンタイトルメントを付与すると、プレイヤーのインベントリにも同期されます。
  3. インベントリサービスから直接コマースアイテムを保存する。アイテムはプレイヤーのエンタイトルメントに反映されます。

アイテムの消費​

  1. プレイヤーのインベントリからアイテムを消費すると、プレイヤーのエンタイトルメントの消費可能なアイテムの useCount 値が減少します。
  2. プレイヤーのエンタイトルメントから直接アイテムを消費すると、インベントリ内のアイテムの数量が減少します。
  3. プレイヤーのエンタイトルメント useCount が0に達すると、エンタイトルメントのステータスが「Consumed」に変更されます。同様のアイテムを追加すると、別の新しいエンタイトルメントエントリが作成されます。
  4. プレイヤーのインベントリからのアイテムの数量が0に達すると、アイテムはプレイヤーのインベントリから削除され、インベントリスペースが解放されます。
  5. エンタイトルメントプロパティが Consumable に設定されているアイテムのみが消費できます。
  6. 耐久性のあるアイテムは消費できません。試行すると失敗します。

アイテムの削除とエンタイトルメントの取り消し​

  1. プレイヤーのインベントリからアイテムを削除すると、プレイヤーのエンタイトルメントから関連アイテムが取り消されます。
  2. サポートされているプラットフォームからプレイヤーのエンタイトルメントを取り消すと、プレイヤーのインベントリから関連アイテムも削除されます。
  3. 耐久性のあるアイテムと消費可能なアイテムは削除または取り消すことができます。

アイテムの移動または転送​

プレイヤーのインベントリからのアイテムは、別のインベントリに分割または部分的に転送できます。このアクション

プレイヤーのインベントリから別のインベントリにアイテムを分割または部分的に転送すると、プレイヤーの関連エンタイトルメントが減少し、新しいエンタイトルメントが作成されます。

備考

インベントリサービスの現在のバージョンは、OTHER ソースからのアイテムのみを処理できます。コマースからのアイテムの処理はまだサポートされていませんが、この機能を有効にするための機能強化が進行中です

インベントリとエンタイトルメントを統合する​

インベントリサービスとエンタイトルメントを統合すると、公開されたストアからのアイテムを希望するインベントリ設定に自動同期できます。

インベントリサービスとエンタイトルメントを統合するには、次の手順に従います。

  1. AGS 管理者ポータルのサイドバーで、Progression & Inventory > Inventory > Integrations に移動します。
  2. Ecommerce Integration Configuration セクションで、+ Add Configuration ボタンをクリックします。
  3. Ecommerce Integration Configuration ウィンドウで、次の操作を行います。
  4. Item Types で、選択したインベントリと同期したい公開されたストアからのアイテムタイプを選択します。
  5. Target Inventory で、公開されたストアからアイテムを同期したいインベントリ設定を選択します。インベントリ設定の設定については、インベントリ設定の設定を参照してください。
  6. Add をクリックして完了します。統合が Ecommerce Integration Configuration ページに表示されます。
  7. ACTIVE トグルをオンにして統合をアクティブ化します。

エンタイトルメントからプレイヤーのインベントリへのアイテム所有権を手動で同期する​

AGS は、データの一貫性を確保するために、プレイヤーインベントリとエンタイトルメントを手動で同期することもサポートしています。このプロセスにより、必要に応じて同期操作を開始でき、両方のシステム間でデータが最新で同一であることが保証されます。

手動同期は、次のシナリオで最適に実行されます。

  • エンタイトルメントを使用していて、インベントリとの同期を開始する予定の場合。
  • インベントリを使用していて、途中でコマースとの統合を無効にし、その後再度有効にした場合。この場合、手動で同期することで、両側が更新され同期されることが保証されます。
に最終更新
On this page