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

# Activer le développement et les tests XStore

> Configurez votre produit XBOX pour le développement et les tests des API XStore dans un bac à sable, y compris les exigences relatives aux droits d'utilisation, aux licences et aux comptes de test.

Les jeux utilisent les [API XStore](https://docs.xbox.com/fr-CA/reference/system/xstore/xstore_members.md) pour effectuer des opérations sur les licences et les droits d'utilisation associés à votre jeu et à ses produits connexes (par exemple, les modules complémentaires). Bon nombre des opérations `XStore` manipulent de l'information sur votre jeu gérée par les services du Microsoft Store.

> [!NOTE]
>
> Cette page a été considérablement mise à jour par rapport aux versions précédentes.

Depuis juin 2023, la plupart[\*](#exceptions) des tests des API `XStore` ne nécessitent plus de configurer la build pour qu'elle puisse faire l'objet d'une licence (par exemple, contentIdOverride) ni que chaque compte dispose d'un droit d'utilisation sur le jeu.

Lorsque vous testez le commerce dans des bacs à sable de développement, tous les achats effectués sur un même compte de test doivent l'être dans le même bac à sable. Le fait de faire passer un compte de test à un autre bac à sable et d'acheter d'autres éléments entraîne des résultats de requête inattendus pour le compte dans les deux bacs à sable. En effet, les licences et l'information d'un achat sont liées au premier bac à sable dans lequel l'élément a été acheté pour un compte donné.

Lorsque vous testez le commerce dans des bacs à sable de développement sur PC, assurez-vous que le compte connecté à l'application Microsoft Store et celui connecté à l'application XBOX sont les mêmes. Dans les bacs à sable, les informations d'identification utilisées pour les éléments du Microsoft Store sont liées précisément au compte XBOX. C'est essentiel pour garantir que toutes les opérations interagissent avec les produits publiés précisément dans le bac à sable actif. Pour plus d'information, consultez [Gestion des scénarios de comptes Store non concordants sur PC](https://docs.xbox.com/fr-CA/publishing/xstore-commerce/xstore-mismatched-accounts.md).

Pour tester la plupart[\*](#exceptions) des API `XStore`, assurez-vous que la configuration du jeu contient les valeurs appropriées provenant de Partner Center.

* **Les API liées aux licences, comme [XStoreQueryGameLicenseAsync](https://docs.xbox.com/fr-CA/reference/system/xstore/xstore_members.md), nécessitent un contexte entièrement sous licence pour fonctionner correctement.** Pour tous les détails, consultez [Activer les tests de licences](https://docs.xbox.com/fr-CA/publishing/xstore-commerce/xstore-licensing-setup.md).

## Appliquer les ID du jeu à MicrosoftGameConfig

Commencez par publier votre jeu et vos modules complémentaires dans [Partner Center](https://docs.xbox.com/fr-CA/publishing/xstore-commerce/xstore-initial-configuration.md).

Ensuite, dans le fichier de configuration du jeu, assurez-vous que les valeurs correspondent au titre que vous avez configuré :

```xml theme={null}
  <Identity
    Name="41336MicrosoftATG.InGameStoreXS"
    Publisher="CN=A4954634-DF4B-47C7-AB70-D3215D246AF1"
    Version="2023.5.5.0" />
  <StoreId>9NTL0QDWZ4FS</StoreId>
  <MSAAppId>000000004C2690C8</MSAAppId>
  <TitleId>62ab3c24</TitleId>
```

### Identity

Se trouve dans Partner Center sous **Game setup > Identity details**.

Sur PC : Doit obligatoirement correspondre à ce qui est attribué à votre jeu dans Partner Center.

Bien que ce ne soit pas obligatoire pour la console, il faut le vérifier lors de la création d'un package destiné à être soumis à Partner Center.

`Name` dans le nœud `Identity` doit correspondre à **Package/Identity/Name**; `Publisher` dans le nœud `Identity` doit correspondre à **Package/Identity/Publisher**.

![Game setup > Identity details avec Package/Identity/Name et Publisher encerclés](https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/xstore/identitydetails_appidentity.png?fit=max\&auto=format\&n=iADzli99B7EWodAv\&q=85\&s=f0f690902c8867bbae062a337589d182)

### StoreID

Se trouve également dans **Game setup > Identity details**

![Game setup > Identity details avec StoreId encerclé dans l'URL et sur la page](https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/xstore/identitydetails_storeid.png?fit=max\&auto=format\&n=iADzli99B7EWodAv\&q=85\&s=1902ced5d2643fa8c1de30281ef96723)

## Documentation de référence des API

* [XStore (contenu de l'API)](https://docs.xbox.com/fr-CA/reference/system/xstore/xstore_members.md)
  * Fonctions
    * [XStoreQueryGameLicenseAsync](https://docs.xbox.com/fr-CA/reference/system/xstore/xstore_members.md)

## Voir aussi

[Vue d'ensemble du commerce](https://docs.xbox.com/fr-CA/publishing/xstore-commerce/xstore-commerce-overview.md)

[Configuration initiale dans Partner Center](https://docs.xbox.com/fr-CA/publishing/xstore-commerce/xstore-initial-configuration.md)

[Activer les tests de licences](https://docs.xbox.com/fr-CA/publishing/xstore-commerce/xstore-licensing-setup.md)

[Changer correctement de bac à sable pour les opérations du Store](https://docs.xbox.com/fr-CA/publishing/xstore-commerce/xstore-switching-sandbox.md)

[Référence de l'API XStore](https://docs.xbox.com/fr-CA/reference/system/xstore/xstore_members.md)


## Related topics

- [Dépannage du développement XStore](https://docs.xbox.com/fr-CA/publishing/xstore-commerce/xstore-troubleshooting.md)
- [Configuration initiale dans Partner Center](https://docs.xbox.com/fr-CA/publishing/xstore-commerce/xstore-initial-configuration.md)
- [XStore sur PC : DRM, jetons de licence et bacs à sable](https://docs.xbox.com/fr-CA/publishing/xstore-commerce/xstore-pc.md)
- [Gérer le contenu téléchargeable (DLC) et ses licences](https://docs.xbox.com/fr-CA/publishing/xstore-commerce/xstore-dlc.md)
- [Activation des tests de licence](https://docs.xbox.com/fr-CA/publishing/xstore-commerce/xstore-licensing-setup.md)
