> ## 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 de l'inventaire des joueurs

> Utilisez le SDK bêta PlayFab pour authentifier un joueur, effectuer une recherche dans le catalogue, acheter un article et vérifier qu'il apparaît dans l'inventaire Economy v2 du joueur.

# Démarrage rapide : Ajouter votre premier article à l'inventaire d'un joueur

<Info>
  Economy v2 est maintenant en disponibilité générale. Pour obtenir du soutien et donner vos commentaires, rendez-vous sur le [forum PlayFab](https://community.playfab.com).
</Info>

Familiarisez-vous avec les inventaires des joueurs en utilisant le SDK bêta PlayFab pour acheter un article et vérifier qu'il a été ajouté à l'inventaire de votre joueur. Après avoir obtenu un jeton d'entité pour interagir avec votre titre au moyen des API, vous recherchez un article dans votre catalogue, l'achetez, puis obtenez l'inventaire du joueur pour y trouver l'article acheté.

## Prérequis

* Un [compte de développeur PlayFab](https://developer.playfab.com)
* Le SDK bêta PlayFab (vous trouverez plus d'information dans le [démarrage rapide Postman](/fr-CA/services/playfab/sdks/postman/postman-quickstart#adding-playfab-collections))
* Au moins un article dans votre catalogue (vous trouverez plus d'information dans le [démarrage rapide d'Economy v2](/fr-CA/services/playfab/economy-monetization/economy-v2/quickstart))
* Au moins un joueur disposant de suffisamment de devise virtuelle pour acheter un article

## Se connecter en tant que joueur

Vous devez d'abord connecter le joueur pour recevoir le jeton de sécurité requis pour les autres appels d'API de ce démarrage rapide. Vous trouverez plus d'information à la page [Authentification des joueurs](/fr-CA/services/playfab/identity/player-identity/login).

## Rechercher l'article

Pour trouver l'article dans le catalogue, appelez `Search`. Dans le corps de l'appel :

```json theme={null}
{
  "Search": "[Item Title]",
  "Top": 1
}
```

* `Search` est la chaîne de recherche qui fait l'objet d'une recherche approximative dans le titre, la description et les mots clés de chaque article de votre catalogue
* `Top` est un entier qui détermine le nombre de résultats à retourner; dans ce cas-ci, nous n'en avons besoin que d'un seul

<Note>
  D'autres champs sont présentés dans le [démarrage rapide de la recherche](/fr-CA/services/playfab/economy-monetization/economy-v2/catalog/search).
</Note>

Dans la réponse, récupérez les champs suivants :

* `Items` > `Id` - ID de catalogue de l'article
* `Items` > `PriceOptions` > `Prices` > `Amounts` > `ItemId` - ID de la devise virtuelle utilisée pour acheter l'article
* `Items` > `PriceOptions` > `Prices` > `Amounts` > `Amount` - Quantité de devise virtuelle nécessaire pour acheter l'article

<Note>
  Seules les entités de titre peuvent définir les prix des articles.
</Note>

## Acheter l'article

Pour acheter l'article, appelez `PurchaseInventoryItems`. Dans le corps de l'appel :

```json theme={null}
{
  "Item": {
    "Id": "{{ItemID}}",
  },
  "Amount": 1,
  "PriceAmounts": [
    {
      "ItemId": "{{CurrencyId}}",
      "Amount": 15
    }
  ]
}
```

* `Item.Id` est l'ID de l'article (tiré de la réponse de `Search` à l'étape précédente)
* `Amount` est le nombre d'articles que le joueur achète
* `ItemId` est l'ID de la devise virtuelle utilisée pour acheter l'article (tiré de la réponse de `Search` à l'étape précédente)
* `Amount` est la quantité de devise virtuelle nécessaire pour acheter l'article (tirée de la réponse de `Search` à l'étape précédente)

## Obtenir les articles d'inventaire du joueur

Consultez l'article nouvellement acheté par le joueur au moyen de `GetInventoryItems`. Dans l'appel, assurez-vous que le corps est vide; vous pouvez spécifier l'entité dans le corps, mais ce n'est pas nécessaire, car l'information est déjà transmise au moyen du jeton d'entité dans l'en-tête.

La réponse contient les ID de chaque article que possède le joueur et la quantité de chaque article. L'article nouvellement acheté se trouve dans l'inventaire du joueur.

<Note>
  Si le joueur possède déjà cet article dans son inventaire avec le même `StackId`, vous ne verrez pas une autre instance de l'article après l'achat; vous verrez plutôt le champ `Amount` augmenter.
</Note>

## Résolution des problèmes

* Fonds insuffisants
  * Si vous appelez `PurchaseInventoryItems` et recevez une erreur `422: InsufficientFunds`, le joueur ne dispose pas de suffisamment de devise virtuelle pour acheter l'article. Vous pouvez octroyer de la devise virtuelle au joueur en appelant `AddInventoryItems` (nécessite un jeton d'entité de titre) ou en accédant à **\[Titre]** > **Players** > **\[Joueur]** > **`Inventory (V2)`** dans Game Manager.
* L'article ne peut pas être acheté au prix spécifié.
  * Si vous appelez `PurchaseInventoryItems` et recevez le code d'erreur `1071`, le champ `PriceAmounts` ne correspond pas aux prix spécifiés dans le catalogue.

## Étapes suivantes

Maintenant que vous avez acheté le premier article du joueur, vous pouvez consommer l'article, l'ajouter à une boutique pour le mettre en vente, et créer et acheter un ensemble contenant l'article.

<Note>
  \[!div class="nextstepaction"] [Tutoriel sur l'inventaire des joueurs](/fr-CA/services/playfab/economy-monetization/economy-v2/tutorials/getting-started-with-unity-and-android)
</Note>

<Note>
  \[!div class="nextstepaction"] [Boutiques](/fr-CA/services/playfab/economy-monetization/economy-v2/catalog/stores)
</Note>

<Note>
  \[!div class="nextstepaction"] [Ensembles](/fr-CA/services/playfab/economy-monetization/economy-v2/catalog/bundles)
</Note>


## Related topics

- [Démarrage rapide](/fr-CA/services/playfab/economy-monetization/economy-v2/quickstart.md)
- [Utilisation de l'inventaire des joueurs](/fr-CA/services/playfab/player-progression/player-data/player-inventory.md)
- [Vue d'ensemble des articles et de l'inventaire](/fr-CA/services/playfab/economy-monetization/economy-v2/inventory/items-and-inventory-overview.md)
- [Démarrage rapide des données des joueurs](/fr-CA/services/playfab/player-progression/player-data/quickstart.md)
- [Démarrage rapide des propriétés personnalisées de joueur](/fr-CA/services/playfab/live-service-management/game-configuration/segmentation/player-custom-properties-qs.md)