> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Démarrage rapide des articles (Economy héritée)

> Démarrage rapide pour la création d'articles de catalogue dans PlayFab Legacy Economy (v1), y compris les propriétés d'articles, les monnaies virtuelles et l'attribution d'articles aux joueurs.

# Démarrage rapide des articles (Economy héritée)

<Info>
  Les API Economy v1 sont en mode maintenance et ne recevront plus de nouvelles fonctionnalités, uniquement des correctifs de bogues. **Les API v1 seront maintenues dans un avenir prévisible.** Consultez la [vue d'ensemble d'Economy v2](/fr/services/playfab/economy-monetization/economy-v2/overview) pour en savoir plus sur la prochaine version de PlayFab Economy !
</Info>

Le démarrage rapide des articles vous fournit les éléments de base de l'économie de votre jeu : monnaie virtuelle, catalogues, articles et achats.

Dans ce démarrage rapide, vous allez :

* Configurer une monnaie virtuelle pour votre jeu.
* Donner de la monnaie virtuelle à un joueur.
* Ajouter un article à votre catalogue en jeu.
* Utiliser les API PlayFab pour acheter un article du catalogue avec de la monnaie virtuelle.
* Utiliser les informations de Game Manager pour confirmer que l'achat a réussi.

## Configuration d'une monnaie virtuelle

PlayFab prend en charge une économie de jeu robuste avec plusieurs monnaies et articles.

Pour accéder à ces fonctionnalités et créer une monnaie virtuelle :

1. Ouvrez **Game Manager** et sélectionnez **Economy** dans la barre latérale gauche.
2. Sélectionnez l'onglet **Currency**, puis **New Currency** (ouvre l'écran **New Currency** illustré ci-dessous).
3. Pour créer votre monnaie virtuelle, modifiez ces champs :
   * Définissez **Currency code (2 uppercase characters)** sur **GD**.
   * Définissez **Display name** sur **Gold**.
4. Sélectionnez **SAVE CURRENCY**.

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-economy-currency-new-currency.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=fcf039d9e16ac42519f73544b6f3a8fd" alt="Enregistrer la nouvelle monnaie" width="1200" height="394" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-economy-currency-new-currency.png" />

## Donner de la monnaie virtuelle à un joueur

Vous pouvez donner directement de la monnaie virtuelle aux joueurs. Par exemple, ajoutons de l'argent à un joueur à l'aide de Game Manager :

1. Sélectionnez **Players** dans la barre latérale gauche, puis sélectionnez l'**ID** d'un joueur.
2. Accédez à l'onglet **Virtual Currency** du joueur.
3. Choisissez la monnaie **GD** (ouvre l'écran **Modify Virtual Currency** illustré ci-dessous).
4. Définissez **Amount** sur **100**.
5. Sélectionnez **SAVE VIRTUAL CURRENCY**.

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-players-modify-virtual-currency.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=5d2fe1627373acec744bdc1b9eee490a" alt="Modifier la monnaie" width="1200" height="698" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-players-modify-virtual-currency.png" />

<Tip>
  Il peut être dangereux de donner aux clients la possibilité d'appeler l'API [AddUserVirtualCurrency](xref:titleid.playfabapi.com.client.playeritemmanagement.adduservirtualcurrency). Pour plus d'informations sur la définition de restrictions sur des API spécifiques, consultez [Stratégie d'accès aux API](/fr/services/playfab/api-references/api-access-policy).
</Tip>

Le joueur dispose maintenant de 100 pièces d'or. Que peut-il en faire ? Acheter un article !

## Ajout d'un article à votre catalogue en jeu

*Inutile d'avoir de l'argent si on ne peut pas le dépenser !*

Vous pouvez créer des catalogues (des collections d'articles) correspondant aux plateformes sur lesquelles vous publiez votre jeu, ou aux numéros de version majeure, selon vos préférences.

<Tip>
  Nous ne recommandons pas de créer plusieurs catalogues pour différencier les types d'articles. Vous pouvez filtrer les articles plus efficacement à l'aide des classes, des balises et des boutiques.
</Tip>

Pour créer un catalogue contenant un article :

1. Sélectionnez **Economy** dans la barre latérale gauche, puis l'onglet **Catalogs**.
2. Sélectionnez le bouton **New Catalog** et saisissez **main** comme **Catalog version**. Un article avec l'ID **One** est ajouté automatiquement.
3. Sélectionnez **One** (ouvre l'écran **Edit Catalog Item** illustré ci-dessous). Modifiez ces champs :
   * Définissez **Item ID** sur **apple**.
   * Définissez **Display name** sur **apple**.
   * Définissez **Description** sur **Perfectly normal apple**.

Le bas du formulaire contient la section **PRICES**, dans laquelle vous définissez le coût d'un article dans la monnaie virtuelle de votre jeu.

1. Définissez le prix de la pomme en or (**GD**) sur **5**.
2. Sélectionnez **SAVE ITEM**.

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-economy-catalogs-edit-catalog-item.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=ae4198cca873fbbc16663f5f7b827423" alt="Ajouter au catalogue" width="1280" height="1200" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-economy-catalogs-edit-catalog-item.png" />

## Achat d'un article avec de la monnaie virtuelle

Utilisons les API PlayFab pour effectuer un achat dans votre jeu.

1. Connectez-vous en tant que joueur auquel 100 pièces d'or de monnaie virtuelle ont été attribuées (comme décrit dans [Donner de la monnaie virtuelle à un joueur](#giving-virtual-currency-to-a-player)).
2. Appelez [GetCatalogItems](xref:titleid.playfabapi.com.client.title-widedatamanagement.getcatalogitems) avec le paramètre suivant dans la requête :
   * `CatalogVersion = "main"`
3. Vérifiez que le `Catalog` du résultat contient une **apple** au prix de **5** **GD**.
4. Achetez la pomme en appelant [PurchaseItem](xref:titleid.playfabapi.com.client.playeritemmanagement.purchaseitem) avec ces valeurs de paramètres dans la requête :
   * `CatalogVersion = "main"`
   * `ItemId = "apple"`
   * `VirtualCurrency = "GD"`
   * `Price = 5`
5. Enfin, appelez [GetUserInventory](xref:titleid.playfabapi.com.client.playeritemmanagement.getuserinventory) et examinez le résultat de cette méthode. Dans le tableau des articles de l'inventaire du joueur, vous devriez voir une pomme !

## Confirmation de la réussite de l'achat

Pour confirmer l'achat dans Game Manager :

1. Sélectionnez **Players** dans la barre latérale gauche pour ouvrir l'onglet **Players**.
2. Sélectionnez l'**ID** du joueur qui a acheté l'article.

Pour confirmer :

* Ouvrez l'onglet **PlayStream**. Vous devriez voir un événement [Player virtual currency item purchased](/fr/services/playfab/api-references/events/Player/player-vc-item-purchased).
* Ouvrez l'onglet **Inventory**. L'inventaire devrait maintenant contenir une pomme. Vous pouvez également utiliser les fonctionnalités de l'onglet **Inventory** pour révoquer l'article ou attribuer *davantage* de pommes au joueur.
* Ouvrez l'onglet **Virtual Currency**. Le joueur ne devrait plus avoir que 95 pièces d'or.


## Related topics

- [Démarrage rapide d'Economy (héritée)](/fr/services/playfab/economy-monetization/economy/quickstart.md)
- [Démarrage rapide des boutiques (Economy héritée)](/fr/services/playfab/economy-monetization/economy/stores/quickstart.md)
- [Démarrage rapide des monnaies virtuelles Economy v2](/fr/services/playfab/economy-monetization/economy-v2/tutorials/currencies.md)
- [Démarrage rapide](/fr/services/playfab/economy-monetization/economy-v2/quickstart.md)
- [Articles (Economy héritée)](/fr/services/playfab/economy-monetization/economy/items/index.md)