Comment grouper et trier les objets dans le catalogue

Ajoutez des objets dans des groupes. Le groupe peut inclure différents ou les mêmes types d’objets :

• Objets virtuels ;
• Monnaie virtuelle ;
• Packages de monnaie virtuelle ;
• Lots ;
• Clés de jeu.

Fonctionnalités principales :

• Ajout du même objet dans plusieurs groupes.
• Modification de l’ordre des groupes.
• Modification l’ordre des objets.

Configurez des groupes :

1. Créez et modifiez des groupes via le Compte éditeur.
2. Ajoutez des objets et récupérez des informations sur les groupes :
   • via le Compte éditeur ;
   • via des appels API.

Configuration dans le Compte éditeur

Créer un groupe

Pour créer un groupe d’objets virtuels :

1. Ouvrez le projet dans le Compte éditeur et accédez à la section Items catalog > All items.
2. Appuyez sur Add et sélectionnez Group dans la liste déroulante.

3. Spécifiez les paramètres suivants :
   • External ID — code de groupe unique ;
   • Group name.
4. Réglez la bascule Show group in Store sur On.
5. Cliquez sur Create group.

Modifier un groupe

Pour modifier un groupe :

1. Ouvrez le projet dans le Compte éditeur et accédez à la section Items catalog > All items.
2. Appuyez sur Show groups.
3. Appuyez sur ⋮ à côté du groupe souhaité et, dans la liste déroulante, sélectionnez Edit.

4. Effectuez les modifications nécessaires et appuyez sur Save changes.

Ajouter un objet au groupe

Pour ajouter un objet virtuel à un groupe requis, spécifiez le groupe :

• lors de la création d’un nouvel objet ;
• lors de la modification d’un objet existant dans le Compte éditeur :
  • dans les paramètres de base de l’objet

• • dans la liste déroulante des groupes dans la liste des objets virtuels

Trier les objets

Pour trier les objets dans un groupe d’objets :

1. Ouvrez le projet dans le Compte éditeur et accédez à la section Items catalog > All items.
2. Appuyez sur Show groups.
3. Accédez au groupe.
4. Survolez le numéro de l’objet virtuel avec la souris. L’icône ☰ s’affiche. Faites glisser l’objet virtuel vers la nouvelle position.

Triez les groupes

Pour trier les groupes :

1. Ouvrez le projet dans le Compte éditeur et accédez à la section Items catalog > All Items.
2. Appuyez sur Show groups.
3. Survolez le nom du groupe avec la souris. L’icône ☰ s’affiche. Faites glisser le groupe vers la nouvelle position.

Configuration via API

Ajouter un objet au groupe

Pour ajouter un objet à un groupe existant via appels API, passez un tableau contenant le paramètre external_id des groupes auxquels l’objet doit appartenir dans le champ group :

• Clés de jeu — utilisez les appels API Créer un jeu, Mettre à jour un jeu par UGS et Mettre à jour un jeu par ID.
• Objets virtuels — utilisez les appels API Créer un objet virtuel et Mettre à jour un objet virtuel.
• Monnaie virtuelle — utilisez les appels API Créer une monnaie virtuelle et Mettre à jour une monnaie virtuelle.
• Package de monnaie virtuelle — utilisez les appels API Créer un package de monnaie virtuelle et Mettre à jour un package de monnaie virtuelle.
• Lots — utilisez les appels API Créer un lot et Mettre à jour un lot.

Exemple de requête :

 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}

Obtenir la liste des groupes

Pour récupérer la liste de tous les groupes, utilisez l’appel API Lire une liste de groupes d’objets. Pour obtenir la liste des objets d’un groupe spécifique, passez le paramètre external_id à l’appel API Lire une liste d’objets par groupe spécifique.

Filtrer les objets

Pour filtrer les objets d’un groupe donné :

1. Récupérez la liste des objets via les appels API suivants :
   • Lire une liste de jeux ;
   • Lire une liste de monnaies virtuelles;
   • Lire une liste de packages de monnaie virtuelle ;
   • Lire une liste de lots.
2. En utilisant le filtrage, trouvez les objets avec le paramètre external_id du groupe requis spécifié dans le paramètre groups.