Utilisation
deventitlementtool <command> /e <testaccountemail> /s <sandboxid> [/p <productid>] [...]
Toutes les commandes nécessitent les paramètres /e (adresse e-mail) et /s (sandbox).
La première connexion avec un compte ouvre une boîte de dialogue interactive de saisie du mot de passe.
Une fois la connexion réussie, les opérations suivantes avec le même compte et le même sandbox sur l’appareil ne nécessitent plus la saisie du mot de passe.
query
deventitlementtool query /e <testaccountemail> /s <sandboxid> [/d]
Répertorie tous les droits détenus directement et associés à ce compte dans le sandbox.
Sortie de query
Exemple de query
add
deventitlementtool add /e <testaccountemail> /s <sandboxid> /p <productid1> [<productid2> <productid3> ...] [/q <quantity>] [/d]
Ajoute au compte un droit pour un ou plusieurs produits spécifiés.
Cette commande équivaut à l’achat du produit depuis le Store ou via l’API d’achat.
L’opération add sur un jeu, un produit durable, un bundle ou un consommable géré par le développeur pour lequel le compte détient déjà un droit n’ajoute pas de nouveau droit, et l’outil signale le droit existant.
Pour les produits consommables gérés par le Store, une quantité par défaut de 1 est ajoutée au solde du consommable à chaque commande add.
Une valeur de quantité facultative peut être spécifiée pour modifier cette valeur par défaut, mais le champ de quantité ne peut être utilisé que si un seul productID est passé avec /p.
Cette option est utile pour les consommables qui accordent une quantité supérieure à 1 lors de l’achat.
L’option /d pour plus de détails est prise en charge.
La quantité n’est pas vérifiable avec cet outil.
add sur un produit de type bundle accorde tous les produits qu’il inclut.
Si une quantité est spécifiée et que le bundle inclut des consommables gérés par le Store, la même quantité est attribuée à chaque consommable.
Les produits d’abonnement ne sont pas pris en charge.
Sortie de add
Exemples de add
Ajout d’un seul droitdelete
deventitlementtool delete /e <testaccountemail> /s <sandboxid> /p <productid1> [<productid2> <productid3> ...] [/all] [/d]
Supprime un ou plusieurs droits spécifiés du compte.
Si /all est spécifié, l’outil tente de supprimer tous les droits associés au compte et au sandbox.
L’état Revoked s’affiche lors de la suppression de droits accordés par cet outil.
L’état Refunded s’affiche lors de la suppression de droits achetés de manière classique via le client du Store ou l’API en jeu.
L’option /d pour plus de détails est prise en charge.
Sortie de delete
Exemples de delete
catalog
deventitlementtool catalog /e <testaccountemail> /s <sandboxid> /p <productid1> [/m]
Affiche l’ensemble des produits pouvant être vendus par l’ID de produit fourni, c’est-à-dire les produits complémentaires enfants et les produits ayant une relation can use and sell avec le productID dans Partner Center.
Cette commande renvoie l’équivalent de XStoreQueryAssociatedProductsAsync.
Les produits configurés dans Partner Center comme available but not discoverable in the Microsoft Store ne sont pas renvoyés.
Vous pouvez éventuellement spécifier un marché pour récupérer les prix de ce marché particulier.
Le paramètre doit être un code de région ISO à deux caractères, par exemple GB, CA, JP, ES, etc.
Sortie de catalog
Exemple de catalog
Remarques
Cet outil est strictement réservé aux comptes de test XBOX et aux produits de sandbox. Son utilisation pour des comptes et des scénarios RETAIL est bloquée. Le nombre d’opérations add et delete par compte et par jour est limité. Cette limite est ajustée en fonction de l’utilisation observée. Pour demander une augmentation des limites ou faire part d’autres commentaires, contactez votre représentant de compte Microsoft.Documentation de référence de l’API
- XStore (contenu de l’API)
- Fonctions
- Structures