カタログのアイテムをグループ分けして並べ替える方法
グループ単位でアイテムを追加し、多階層のカタログを作成することができます。グループには、同一のもの、異なるタイプのものを含めることができます:
- 仮想アイテム
- 仮想通貨
- 仮想通貨のパッケージ
- バンドル
- ゲームキー
お知らせ
アドミンページのアイテム カタログ内のアイテムを並べ替えることができません。
主な機能:
- 同じ項目を複数グループに分けて追加します。
- 大きなものに小さなグループを追加して、マルチレベルのカタログを作成します。
- グループの順番を変更します。
- アイテムの順序を変更します。
以下のいずれかの方法でグループをセットアップします:
アドミンページ経由のセットアップ
グループを作成する
仮想アイテムのグループを作成するには:
- アドミンページでプロジェクトを開きます。
- サイドメニューの「ストア」をクリックします。
- 仮想アイテムペインで、以下をクリックします:
- 接続 - 仮想アイテムがない場合。
- 構成 - 以前に仮想アイテムを接続したことがある場合。
- +をクリックしてドロップダウンリストでグループを作成するを選択します。
- 以下のパラメータを指定します:
- External ID — ユニークなグループコードです。
- グループ名。
- ストアにグループを表示するトグルをオンに設定します。
- グループを作成するをクリックします。
グループを編集する
グループを編集するには:
- アドミンページでプロジェクトを開きます。
- サイドメニューのストアをクリックします。
- 仮想アイテムペインで、•••をクリックし、ドロップダウンリストで グループを編集するを選択します。
- 必要な変更を行います。
- 変更を保存するをクリックします。
お知らせ
ストアでグループを非表示にしている(ストアでグループを表示するトグルをオフに設定している)場合、そのようなグループは:
- アイテムグループリストを取得するAPIを呼び出したときの応答で返されません。
- アイテムのリストを取得するためのクライアントメソッドを呼び出したときに、このグループに含まれるアイテムのプロパティに表示されません。
グループにアイテムを追加する
仮想アイテムを必須のグループに追加するには、新規アイテムの作成時や既存アイテムの編集時にグループを指定します。お知らせ
特定のグループを持たないアイテムは、グループリストの最後にあるUngrouped グループに自動的に追加されます。このグループのアイテムには以下の制限があります:
- 並べ替えはできません。
- 指定したグループでアイテムリストを取得するAPI を介して呼び出すことはできません。
アイテムの並べ替え
アイテムを並べ替えるには(仮想アイテムの例で):- アドミンページでプロジェクトを開きます。
- サイドメニューのストアをクリックします。
- 仮想アイテムペインで、以下をクリックします:
- 接続 – 仮想アイテムがない場合。
- 構成 — 以前は仮想アイテムに接続された場合。
- グループに移動します。
- 仮想アイテム番号にカーソルを合わせます。☰アイコンが表示されます。 仮想アイテムを新しい位置にドラッグします。
APIコール経由のセットアップ
グループにアイテムを追加する
APIコールで既存のグループにアイテムを追加するには、アイテムが属するべきグループのexternal_id
パラメータを含む配列をgroup
フィールドに渡します:
- ゲームキー — ゲームを作成する、SKUによるゲームを更新するとIDによるゲームを更新するAPIコールを使用します。
- 仮想アイテム:仮想アイテムを作成すると仮想アイテムを更新するAPIコールを使用します。
- 仮想通貨:仮想通貨を作成すると仮想通貨を更新するAPIコールを使用します。
- 仮想通貨パッケージ:仮想通貨パッケージを作成すると仮想通貨パッケージを更新するAPIコールを使用します。
- バンドル:バンドルを作成するとバンドルを更新するAPIコールを使用します。
リクエストの例:
Copy
- http
{
"sku": "sword",
"name": {
"en": "Sword",
},
"is_enabled": true,
"is_free": false,
"order": 1,
"description": {
"en": "A sword is a bladed melee weapon intended for cutting or thrusting that is longer than a knife or dagger, consisting of a long blade attached to a hilt.",
},
"prices": [
{
"amount": 100,
"currency": "USD",
"Is_enabled": true,
"is_default": true
}
],
"vc_prices": [ ],
"is_show_in_store": true,
"groups": [
"chests", "bonus"
],
}
グループのリストを取得する
注意
全てのグループのリストと指定したグループのアイテムのリストを、仮想アイテムのみのAPIコールで取得することができます。他のグループのアイテムを操作する際にはフィルタリングを使用します。
external_id
パラメーターを渡します。項目を絞り込む
必須なグループのアイテム絞り込むには:- 以下のAPIコールでアイテムのリストを取得します:
- ゲームキー:ゲームリストを取得するAPIコール。
- 仮想通貨:仮想通貨リストを取得するAPIコール。
- 仮想通貨パッケージ:仮想通貨パッケージリストを取得するAPIコール。
- バンドル:バンドルリストを取得するAPIコール。
- フィルタリングを使用して、
groups
パラメータで指定した必須グループのexternal_id
パラメータを持つアイテムを探します。
この記事は役に立ちましたか?
ご意見ありがとうございました!
あなたのメッセージを確認し、体験を向上させるために利用させていただきます。誤字脱字などのテキストエラーを見つけましたか? テキストを選択し、Ctrl+Enterを押します。