> ## 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 objets (Economy hérité)

> Démarrage rapide pour créer des objets de catalogue dans PlayFab Economy hérité (v1), y compris les propriétés d'objet, les monnaies virtuelles et l'attribution d'objets aux joueurs.

# Démarrage rapide des objets (Economy hérité)

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

Le démarrage rapide des objets vous fournit les éléments de base de l'économie de votre jeu : monnaie virtuelle, catalogues, objets 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 objet à votre catalogue en jeu.
* Utiliser les API PlayFab pour acheter un objet du catalogue avec de la monnaie virtuelle.
* Utiliser l'information 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 comportant plusieurs monnaies et objets.

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** (ce qui ouvre l'écran **New Currency** illustré ci-dessous).
3. Pour créer votre monnaie virtuelle, modifiez ces champs :
   * Réglez **Currency code (2 uppercase characters)** à **GD**.
   * Réglez **Display name** à **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. À titre d'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** (ce qui ouvre l'écran **Modify Virtual Currency** illustré ci-dessous).
4. Remplacez **Amount** par **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 savoir comment définir des restrictions sur des API précises, consultez [Stratégie d'accès aux API](/fr-CA/services/playfab/api-references/api-access-policy).
</Tip>

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

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

*Inutile d'avoir de l'argent si vous ne pouvez pas le dépenser!*

Vous pouvez créer des catalogues (une collection d'objets) qui correspondent aux plateformes sur lesquelles vous publiez votre jeu, ou aux numéros de version majeure, selon ce que vous préférez.

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

Pour créer un catalogue contenant un objet :

1. Sélectionnez **Economy** dans la barre latérale gauche, puis l'onglet **Catalogs**.
2. Sélectionnez le bouton **New Catalog** et entrez **main** comme **Catalog version**. Un objet ayant l'ID **One** est ajouté automatiquement.
3. Sélectionnez **One** (ce qui ouvre l'écran **Edit Catalog Item** illustré ci-dessous). Modifiez ces champs :
   * Réglez **Item ID** à **apple**.
   * Réglez **Display name** à **apple**.
   * Réglez **Description** à **Perfectly normal apple**.

Le bas du formulaire comporte la section **PRICES**, où vous définissez le coût d'un objet dans la monnaie virtuelle de votre jeu.

1. Réglez le prix de la pomme en or (**GD**) à **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 objet avec de la monnaie virtuelle

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

1. Connectez-vous en tant que joueur ayant reçu 100 pièces d'or en monnaie virtuelle (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 un objet **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 objets 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'objet.

Pour confirmer :

* Ouvrez l'onglet **PlayStream**. Vous devriez voir un événement [Player virtual currency item purchased](/fr-CA/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'objet ou accorder *davantage* de pommes au joueur.
* Ouvrez l'onglet **Virtual Currency**. Il ne devrait plus rester que 95 pièces d'or au joueur.


## Related topics

- [Démarrage rapide d'Economy (hérité)](/fr-CA/services/playfab/economy-monetization/economy/quickstart.md)
- [Démarrage rapide des magasins (Economy hérité)](/fr-CA/services/playfab/economy-monetization/economy/stores/quickstart.md)
- [Catalogues (Economy hérité)](/fr-CA/services/playfab/economy-monetization/economy/items/catalogs.md)
- [Objets (Economy hérité)](/fr-CA/services/playfab/economy-monetization/economy/items/index.md)
- [Démarrage rapide](/fr-CA/services/playfab/economy-monetization/economy-v2/quickstart.md)