カタログのアイテムをグループ分けして並べ替える方法

グループにアイテムを追加することができます。グループには、同一のもの、異なるタイプのものを含めることができます：

• 仮想アイテム
• 仮想通貨
• 仮想通貨パッケージ
• バンドル
• ゲームキー

主な機能：

• 同一アイテムを複数のグループに追加します。
• グループの順序を変更します。
• アイテムの順序を変更します。

グループを設定します：

1. パブリッシャーアカウント経由でグループを作成および編集します。
2. アイテムを追加してグループ情報を取得します：
   • パブリッシャーアカウント経由
   • APIコール経由

パブリッシャーアカウント経由のセットアップ

グループを作成する

仮想アイテムのグループを作成するには：

1. パブリッシャーアカウントでプロジェクトを開き、アイテムカタログ > すべてのアイテムセクションに移動します。
2. 「追加」をクリックして、ドロップダウンリスト「グループ」を選択します。

3. 以下のパラメータを指定します：
   • External ID — ユニークなグループコードです。
   • グループ名。
4. ストアにグループを表示するトグルをオンに設定します。
5. グループを作成するをクリックします。

グループを編集する

グループを編集するには：

1. パブリッシャーアカウントでプロジェクトを開き、アイテムカタログ > すべてのアイテムセクションに移動します。
2. 「グループを表示」をクリックします。
3. 対象のグループの横にある「⋮」をクリックし、ドロップダウンリストから「編集」を選択します。

4. 必要な変更を行い、「変更内容を保存する」をクリックします。

グループにアイテムを追加する

仮想アイテムを必要なグループに追加するには、以下のタイミングでグループを指定してください：

• 新しいアイテムを作成する時
• パブリッシャーアカウントで既存のアイテムを編集する時：
  • アイテムの基本設定内

• • 仮想アイテムリスト内にある、グループのドロップダウンリストから指定します

アイテムの並べ替え

アイテムを並べ替えるには（仮想アイテムの例で）：

1. パブリッシャーアカウントでプロジェクトを開き、アイテムカタログ > すべてのアイテムセクションに移動します。
2. 「グループを表示」をクリックします。
3. グループに移動します。
4. 仮想アイテム番号の上にマウスを重ねると、「☰」アイコンが表示されます。その仮想アイテムを新しい位置にドラッグしてください。

グループの並べ替え

グループを並べ替えるには：

1. パブリッシャーアカウントでプロジェクトを開き、アイテムカタログ > すべてのアイテムセクションに移動します。
2. 「グループを表示」をクリックします。
3. グループ名の上にマウスを重ねると、「☰」アイコンが表示されます。そのグループを新しい位置にドラッグしてください。

API経由のセットアップ

グループにアイテムを追加する

APIコールで既存のグループにアイテムを追加するには、アイテムが属するべきグループのexternal_idパラメータを含む配列をgroupフィールドに渡します：

• ゲームキー — ゲームを作成する、SKUによるゲームを更新するとIDによるゲームを更新するAPIコールを使用します。
• 仮想アイテム：仮想アイテムを作成すると仮想アイテムを更新するAPIコールを使用します。
• 仮想通貨：仮想通貨を作成すると仮想通貨を更新するAPIコールを使用します。
• 仮想通貨パッケージ：仮想通貨パッケージを作成すると仮想通貨パッケージを更新するAPIコールを使用します。
• バンドル：バンドルを作成するとバンドルを更新するAPIコールを使用します。

リクエストの例：

 1{
 2  "sku": "sword",
 3  "name": {
 4    "en": "Sword"
 5  },
 6  "is_enabled": true,
 7  "is_free": false,
 8  "order": 1,
 9  "description": {
10    "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."
11  },
12  "prices": [
13    {
14      "amount": 100,
15      "currency": "USD",
16      "is_enabled": true,
17      "is_default": true
18    }
19  ],
20  "vc_prices": [],
21  "is_show_in_store": true,
22  "groups": [
23    "chests",
24    "bonus"
25  ]
26}

グループのリストを取得する

全部のグループのリストを取得するには、アイテムグループリストを取得するAPIコールを使用します。指定したグループのアイテムのリストを取得するには、指定したグループによりアイテムリストを取得する APIコールにexternal_idパラメータを渡します。

項目を絞り込む

必須なグループのアイテム絞り込むには：

1. 以下のAPIコールでアイテムのリストを取得します：
   • ゲームリストを取得する
   • 仮想通貨リストを取得する
   • 仮想通貨パッケージリストを取得する
   • バンドルリストを取得する
2. フィルタリングを使用して、groupsパラメータで指定した必須グループのexternal_idパラメータを持つアイテムを探します。