Comment créer et mettre à jour un catalogue des objets en utilisant l’importation JSON
Vous pouvez créer, mettre à jour ou désactiver des objets en utilisant l’importation à partir d’un fichier JSON.
Note
Vous pouvez créer, mettre à jour ou désactiver des objets en utilisant des appels API ou manuellement dans le Compte éditeur. Toutefois, ces deux approches impliquent une demande ou une action distincte pour chaque objet. Avec l’importation, en revanche, vous pouvez accomplir ces actions pour plusieurs objets simultanément en les spécifiant dans un seul fichier JSON.
Cet outil vous permet :
Fonctionnalités :
- Prise en charge des types de biens suivants :
- objets virtuels ;
- monnaie virtuelle ;
- packages de monnaie virtuelle ;
- lots.
- Validation des données. Si la structure du fichier ou le format des données ne répond pas aux exigences, une liste d’erreurs s’affiche lors de l’importation.
Limites :
- L’importation n’est pas disponible pour les clés de jeu, les promotions et les systèmes de récompense.
- La taille du fichier JSON téléchargé ne doit pas dépasser 7 Mo.
- Le format des paramètres dans le fichier JSON doit correspondre au format spécifié dans la méthode de création du produit correspondant :
Note
Pour les objets pré-créés, vous pouvez importer des prix régionaux à partir d’un fichier CSV.
Importation du catalogue des objets
Pour importer un catalogue des objets à partir d’un fichier :
- Ouvrez le projet dans le Compte éditeur.
- Dans le menu latéral, cliquez sur Store et accédez à la section Virtual currency, Virtual items ou Bundles.
- Cliquez sur Import items.
- Choisissez l'action :
- Add new items — seuls les objets avec de nouvelles UGS seront ajoutés ;
- Add new items and update existing ones — les objets avec de nouvelles UGS seront ajoutés et les données des objets existants seront mises à jour ;
- Add new, update existing, disable missing items — les objets avec des UGS provenant du fichier seront ajoutés/mis à jour. S'il existe un objet dans le catalogue, mais qu'il n'y a pas d'UGS correspondante dans le fichier, le statut de l'objet dans le Compte éditeur sera changé en Partially available — l'objet ne peut pas être acheté séparément, mais est disponible dans le cadre d'un lot ou d'un bonus.
- Remplissez le fichier pour l'importation :
- Téléchargez le modèle de fichier dans la fenêtre de téléchargement et remplissez-le selon l'exemple ci-dessous ;
- Exportez les objets et utilisez le fichier exporté comme modèle ;
- Créez votre propre fichier JSON et remplissez-le selon l'exemple ci-dessous.
Exemple de fichier JSON complet :
Copy
- json
{
"virtual_currency": [
{
"sku": "Gem_test_import",
"name": {
"en": "Gem_test_import"
},
"type": "virtual_currency",
"description": {
"en": "my test imported currency"
},
"image_url": "https://cdn3.xsolla.com/img/misc/merchant/default-dc-image.png",
"description": {
"en": "my test imported currency",
"de": "meine importierte Testwährung"
},
"attributes": [],
"is_free": false,
"order": 1,
"groups": [],
"regional_prices": [],
"prices": [
{
"amount": 2,
"currency": "USD",
"is_default": true,
"is_enabled": true
}
],
"media_list": [],
"vc_prices": [],
"is_enabled": true,
"is_show_in_store": true,
"regions": [],
"limits": {
"per_user": null,
"per_item": null,
"recurrent_schedule": null
},
"periods": [],
"inventory_options": {
"consumable": true,
"expiration_period": null
},
"is_hard": false
}
],
"virtual_items": [
{
"sku": "event_access_test_import",
"name": {
"en": "Special Event Access_test_import"
},
"type": "virtual_good",
"description": {
"en": "Get special event access as a bonus only on your first purchase. Find the right doggy at the Robo-Dog Exhibition!"
},
"image_url": "https://cdn3.xsolla.com/img/misc/images/1e3ef1a96cc9dd8d98bc124d5d6fad79.png",
"long_description": null,
"attributes": [],
"is_free": false,
"order": 1,
"groups": [
"my_test_group"
],
"regional_prices": [],
"prices": [
{
"amount": 35,
"currency": "USD",
"is_default": true,
"is_enabled": true
}
],
"media_list": [],
"vc_prices": [],
"is_enabled": true,
"is_show_in_store": true,
"regions": [],
"limits": {
"per_user": null,
"per_item": null,
"recurrent_schedule": null
},
"periods": [],
"inventory_options": {
"consumable": true,
"expiration_period": null
}
}
],
"virtual_currency_packages": [
{
"item_id": 441982,
"sku": "small_gold_pack_test_import",
"type": "bundle",
"name": {
"en": "Small gold pack"
},
"bundle_type": "virtual_currency_package",
"description": {
"en": "Gold x100"
},
"image_url": "https://cdn3.xsolla.com/img/misc/images/ba43c46ea75fd5713c210f5736993a92.png",
"vc_prices": [],
"regional_prices": [],
"prices": [
{
"amount": 5,
"currency": "USD",
"is_default": true,
"is_enabled": true
}
],
"is_enabled": true,
"is_show_in_store": true,
"regions": [],
"limits": {
"per_user": null,
"per_item": null,
"recurrent_schedule": null
},
"periods": [],
"attributes": [],
"long_description": null,
"media_list": [],
"order": 100000000,
"is_free": false,
"groups": [],
"content": [
{
"sku": "Gem_test_import",
"quantity": 100
}
]
}
],
"bundles": [
{
"item_id": 684024,
"sku": "start_pack_test_import_test_import",
"type": "bundle",
"name": {
"en": "Legendary Start Pack"
},
"bundle_type": "standard",
"description": {
"en": "Crystal x 1\nGem x 1"
},
"image_url": "https://cdn3.xsolla.com/img/misc/merchant/default-dc-image.png",
"regional_prices": [],
"prices": [
{
"amount": 20,
"currency": "USD",
"is_default": true,
"is_enabled": true
}
],
"virtual_prices": [],
"is_enabled": true,
"is_show_in_store": true,
"regions": [],
"limits": {
"per_user": null,
"per_item": null,
"recurrent_schedule": null
},
"periods": [],
"attributes": [],
"long_description": null,
"media_list": [],
"order": 5,
"is_free": false,
"groups": [
"my_test_group"
],
"content": [
{
"sku": "Gem_test_import",
"quantity": 1
},
{
"sku": "event_access_test_import",
"quantity": 1
}
]
}
]
}
- Téléchargez le fichier dans le champ correspondant de la fenêtre d’importation.
- En cas d’erreurs lors de l’importation, une liste de celles-ci avec les recommandations de correction s'affiche dans la fenêtre d'importation. Apportez les modifications nécessaires au fichier et téléchargez-le à nouveau.
Après le téléchargement réussi, les objets avec les UGS spécifiées seront créés, mis à jour ou désactivés.
Exportation du catalogue des objets
Pour exporter un objet ou un catalogue des objets vers un fichier JSON :
- Ouvrez le projet dans le Compte éditeur.
- Dans le menu latéral, cliquez sur Store et accédez à la section Virtual currency, Virtual items ou Bundles.
- Cliquez sur Export items.
- Choisissez l'action :
- Export all items — le catalogue complet de tous les types de biens de ce projet sera exporté. Par exemple, si vous accédez à la section Virtual Currency et exportez tous les objets, le fichier JSON déchargera les monnaies virtuelles, les packages de monnaie virtuelle, les objets virtuels et les packages de clés de jeu de votre projet ;
- Export only selected items — dans la fenêtre qui s'affiche, sélectionnez les objets à exporter.
- Cliquez sur Export.
Le téléchargement du fichier JSON démarre automatiquement.
Cet article vous a été utile ?
Merci pour votre commentaire !
Nous examinerons votre message et l'utiliserons pour améliorer votre expérience.Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entée.
