Vous recherchez la référence REST de service à service du Microsoft Store (collections, achat, récupération, octroi, récurrences) ? Elle se trouve dans l’onglet API, sous API REST du Microsoft Store.
Dans cette section
Prise en main
Vue d’ensemble, types de produits, configuration de Partner Center, tests, licences et résolution des problèmes.
Notions de base
Opérations de base du Store, DLC, versions d’évaluation, consommables, offres groupées, DWOB et mises à jour.
Gestion à partir de vos services
Authentification des services, interrogation des droits d’utilisation, abonnements, remboursements et ID User Store.
Considérations propres au PC
DRM, jetons de licence, gestion des comptes Store non concordants et changement de sandbox.
API REST du Microsoft Store
Référence des points de terminaison v8/v9 de collections, d’achat, de récupération, d’octroi et de récurrences. La référence complète se trouve désormais dans l’onglet API, sous API REST du Microsoft Store.
Hubs de franchise de jeux
Regroupez plusieurs produits sous un même hub de franchise du Store.
Vue d’ensemble : comment les éléments s’articulent
- Partner Center — où vous créez des produits (jeux de base, extensions, offres groupées, Season Pass, abonnements, consommables), définissez la tarification et la disponibilité, et attribuez des identificateurs (StoreId, Product ID, BigId, SKU ID).
MicrosoftGame.config— fourni dans le package de votre titre, il lie l’exécutable en cours d’exécution au produit du Store viaTitleId,StoreIdetMSAAppId.- API runtime XStore (
XStore*) — appels côté client effectués depuis votre jeu pour énumérer les produits, interroger les licences et les droits d’utilisation, afficher l’interface d’achat et signaler le traitement des consommables. - API XPackage (
XPackage*) — montent les packages facultatifs (DLC) et leur accordent une licence, installent des segments et observent les changements d’état des packages. - API REST S2S du Microsoft Store — points de terminaison côté serveur que votre back-end appelle pour interroger de manière fiable les droits d’utilisation, traiter les consommables, octroyer des produits, rechercher des abonnements et traiter les remboursements/récupérations.
- ID User Store (UserStoreId) — une clé de courte durée que votre titre obtient via
XUserGetTokenAndSignatureAsync(ouXStoreGetUserCollectionsIdAsync/XStoreGetUserPurchaseIdAsync) et transmet à votre service afin que celui-ci puisse appeler le Store au nom de cet utilisateur.
Client ou service
Presque tous les scénarios du Store comportent à la fois un chemin côté client (XStore) et un chemin côté service (REST S2S). Utilisez le client pour l’expérience utilisateur en temps réel (afficher le bouton d’achat, débloquer du contenu, signaler une dépense de consommable) ; utilisez le service lorsque la fiabilité est essentielle (traiter une dépense de monnaie virtuelle qui doit survivre aux réinstallations du titre, octroyer un élément promotionnel, détecter Game Pass, traiter un remboursement). Un modèle fiable :- Le client détecte l’achat ou la dépense et affiche immédiatement l’expérience utilisateur.
- Le client envoie un UserStoreId à votre service.
- Le service appelle l’API S2S du Store pour confirmer le droit d’utilisation ou traiter le consommable, puis met à jour votre base de données de référence.