> ## 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 du joueur
> Utilisez le SDK bêta de PlayFab pour authentifier un joueur, effectuer une recherche dans le catalogue, acheter un objet et vérifier qu'il apparaît dans l'inventaire Economy v2 du joueur.
# Démarrage rapide : ajouter votre premier objet à l'inventaire d'un joueur
Economy v2 est désormais en disponibilité générale. Pour obtenir de l'aide et donner votre avis, rendez-vous sur le [forum PlayFab](https://community.playfab.com).
Familiarisez-vous avec les inventaires des joueurs en utilisant le SDK bêta de PlayFab pour acheter un objet et vérifier qu'il a bien été ajouté à l'inventaire de votre joueur. Après avoir obtenu un jeton d'entité pour interagir avec votre titre via les API, vous recherchez un objet dans votre catalogue, l'achetez, puis récupérez l'inventaire du joueur pour y trouver l'objet acheté.
## Prérequis
* Un [compte développeur PlayFab](https://developer.playfab.com)
* Le SDK bêta de PlayFab (vous trouverez plus d'informations dans le [démarrage rapide Postman](/fr/services/playfab/sdks/postman/postman-quickstart#adding-playfab-collections))
* Au moins un objet dans votre catalogue (vous trouverez plus d'informations dans le [démarrage rapide Economy v2](/fr/services/playfab/economy-monetization/economy-v2/quickstart))
* Au moins un joueur disposant de suffisamment de devise virtuelle pour acheter un objet
## Se connecter en tant que joueur
Vous devez d'abord connecter le joueur afin de recevoir le jeton de sécurité requis pour les autres appels d'API de ce démarrage rapide. Vous trouverez plus d'informations sur la page [Authentification des joueurs](/fr/services/playfab/identity/player-identity/login).
## Rechercher l'objet
Pour trouver l'objet 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 utilisée pour une recherche approximative dans le titre, la description et les mots clés de chaque objet de votre catalogue
* `Top` est un entier qui détermine le nombre de résultats à renvoyer ; dans ce cas, nous n'en avons besoin que d'un seul
Vous pouvez découvrir d'autres champs dans le [démarrage rapide de la recherche](/fr/services/playfab/economy-monetization/economy-v2/catalog/search).
Dans la réponse, récupérez les champs suivants :
* `Items` > `Id` - ID de catalogue de l'objet
* `Items` > `PriceOptions` > `Prices` > `Amounts` > `ItemId` - ID de la devise virtuelle utilisée pour acheter l'objet
* `Items` > `PriceOptions` > `Prices` > `Amounts` > `Amount` - Quantité de devise virtuelle nécessaire pour acheter l'objet
Seules les entités de titre peuvent définir les prix des objets.
## Acheter l'objet
Pour acheter l'objet, 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'objet (extrait de la réponse `Search` de l'étape précédente)
* `Amount` est le nombre d'objets que le joueur achète
* `ItemId` est l'ID de la devise virtuelle utilisée pour acheter l'objet (extrait de la réponse `Search` de l'étape précédente)
* `Amount` est la quantité de devise virtuelle nécessaire pour acheter l'objet (extraite de la réponse `Search` de l'étape précédente)
## Obtenir les objets d'inventaire du joueur
Consultez l'objet nouvellement acheté par le joueur via `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 par le jeton d'entité dans l'en-tête.
La réponse contient les ID de chaque objet que possède le joueur ainsi que la quantité de chaque objet. L'objet nouvellement acheté se trouve dans l'inventaire du joueur.
Si le joueur possède déjà cet objet dans son inventaire avec le même `StackId`, vous ne verrez pas d'autre instance de l'objet après l'achat ; vous verrez plutôt le champ `Amount` augmenter.
## 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'objet. Vous pouvez octroyer de la devise virtuelle au joueur en appelant `AddInventoryItems` (nécessite un jeton d'entité de titre) ou en accédant à **\[Title]** > **Players** > **\[Player]** > **`Inventory (V2)`** dans Game Manager.
* L'objet 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 objet du joueur, vous pouvez consommer l'objet, l'ajouter à une boutique pour le mettre en vente, et créer et acheter un lot contenant l'objet.
\[!div class="nextstepaction"] [Tutoriel sur l'inventaire du joueur](/fr/services/playfab/economy-monetization/economy-v2/tutorials/getting-started-with-unity-and-android)
\[!div class="nextstepaction"] [Boutiques](/fr/services/playfab/economy-monetization/economy-v2/catalog/stores)
\[!div class="nextstepaction"] [Lots](/fr/services/playfab/economy-monetization/economy-v2/catalog/bundles)
## Related topics
- [Utilisation de l'inventaire des joueurs](/fr/services/playfab/player-progression/player-data/player-inventory.md)
- [Démarrage rapide des propriétés personnalisées de joueur](/fr/services/playfab/live-service-management/game-configuration/segmentation/player-custom-properties-qs.md)
- [Démarrage rapide](/fr/services/playfab/economy-monetization/economy-v2/quickstart.md)
- [Démarrage rapide d'Economy (héritée)](/fr/services/playfab/economy-monetization/economy/quickstart.md)
- [Démarrage rapide des échanges](/fr/services/playfab/economy-monetization/economy/trading/trading-quickstart.md)