カタログ作成
エクソーラ側で仮想アイテムを作成すると、地域ごとの価格と制限を設定できるだけでなく、定期的に拡張および更新されるプロモーション システムやその他のエクソーラ機能を使用することもできます。
グループを作成する
仮想アイテムを設定するには、仮想アイテムグループを構成する必要があります。グループを使用すると、複数レベルのカタログを作成し、ストアに表示されるアイテムを管理できます。
- アドミンページでプロジェクトを開きます。
- サイドメニューでストアをクリックします。
- 仮想アイテムペインで、以下をクリックします：
- 接続 — 以前に仮想アイテムを構成したことがない場合。
- 構成 — 以前に仮想アイテムを構成した場合。
- ドロップダウンリストからグループを作成するを選択します。
- 次のパラメータを指定します：
- External ID — APIコールによる仮想アイテムグループの管理に使用されるストア内のグループID。グループごとに一意である必要があります。
- グループ名。
- ストアにこのグループのアイテムを表示するには、ストアにグループを表示するトグルをオンに設定します。
- グループを作成するをクリックします。
仮想アイテムを作成する
- 作成したグループの名前をクリックします。
- アイテムを作成するをクリックします。
- アイテムに関する情報を指定します。必須フィールド：
- SKU — 一意のアイテムID
- アイテム名
- 説明
- 実際通貨での価格
- ストアにアイテムを表示するトグルをオンに設定します。
- アイテムを作成するをクリックします。
仮想アイテムをセットアップするには、仮想アイテム＆通貨グループの管理者サブセクションからの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キー
APIキーの操作については、APIリファレンスを参照してください。
キーに関する推奨事項：
- 生成されたAPIキーは、お客様側で保存してください。APIキーは、アドミンページで作成時に一度だけ表示することができます。
- APIキーは秘密にしておいてください。APIキーは、お客様の個人アカウントとアドミンページのプロジェクトへのアクセスを提供します。
- APIキーはサーバーに保存する必要があり、決してバイナリやフロントエンドに保存してはいけません。
必要なAPIコールにproject_idパスパラメータが含まれていない場合は、会社のすべてのプロジェクトで有効なAPIキーを使用して認証を設定します。
クライアント側で仮想アイテムのカタログを取得するには、仮想アイテム＆通貨グループのカタログサブセクションからのAPIコールを使用します。これらの呼び出しは基本的な認証を必要としません。
グループに分かれていないアイテムの完全なリストを取得するには、仮想アイテムリストを取得するAPIコールを使用します。特定のグループからアイテムのリストを取得するには、指定したグループからアイテムリストを取得するコールにexternal_idパラメータを渡します。
誤字脱字などのテキストエラーを見つけましたか？ テキストを選択し、Ctrl+Enterを押します。
