エクソーラ側で仮想アイテムを作成すると、地域ごとの価格と制限を設定できるだけでなく、定期的に拡張および更新されるプロモーション システムやその他のエクソーラ機能を使用することもできます。

グループを作成する

仮想アイテムを設定するには、仮想アイテムグループを構成する必要があります。グループを使用すると、複数レベルのカタログを作成し、ストアに表示されるアイテムを管理できます。

1. アドミンページでプロジェクトを開きます。
2. サイドメニューでストアをクリックします。
3. 仮想アイテムペインで、以下をクリックします：
   • 接続 — 以前に仮想アイテムを構成したことがない場合。
   • 構成 — 以前に仮想アイテムを構成した場合。
4. ドロップダウンリストからグループを作成するを選択します。

5. 次のパラメータを指定します：
   • External ID — APIコールによる仮想アイテムグループの管理に使用されるストア内のグループID。グループごとに一意である必要があります。
   • グループ名。
6. ストアにこのグループのアイテムを表示するには、ストアにグループを表示するトグルをオンに設定します。
7. グループを作成するをクリックします。

仮想アイテムを作成する

1. 作成したグループの名前をクリックします。
2. アイテムを作成するをクリックします。

3. アイテムに関する情報を指定します。必須フィールド：
   • SKU — 一意のアイテムID
   • アイテム名
   • 説明
   • 実際通貨での価格
4. ストアにアイテムを表示するトグルをオンに設定します。
5. アイテムを作成するをクリックします。

次のステップでは、作成したアイテムのSKUが必要です。

仮想アイテムを設定するには、Virtual Items & CurrencyグループのAdminサブセクションからのAPIコールを使用します。

APIコールには基本的な認証が使用されます。Authorization:Basic <your_authorization_basic_key>を渡し、そこで、<your_authorization_basic_key>はマーチャントID：APIキーペア、はBase64規格に基づいてエンコードされています。アドミンページに移動して、以下のパラメータを見つかります：

• マーチャントIDは以下の場所で表示されます：
  • 会社設定 > 会社セクション。
  • アドミンページページのブラウザーアドレスバーのURL。URLは以下の形式があります：https:​//publisher.xsolla.com/<merchant ID>/<Publisher Account section>。

• APIキーは、作成時に一度だけアドミンページに表示され、お客様側で保存する必要があります。次のセクションで新しいキーを作成できます：
  • 会社設定 > APIキー
  • プロジェクト設定 > APIキー

クライアント側で仮想アイテムのカタログを取得するには、Virtual Items & CurrencyグループのCatalogサブセクションからのAPIコールを使用します。これらの呼び出しは基本的な認証を必要としません。

グループに分割されていない項目の完全なリストを取得するには、Get virtual items list APIコールを使用します。定数グループから項目のリストを取得するには、external_idパラメータをGet items list by specified group呼び出しに渡します。