Passer au contenu principal
Les commandes game répertorient les jeux Partner Center d’un vendeur, en recherchent un par ID Store, ID de titre XBOX ou nom, créent un jeu et vérifient son travail de création. Chaque commande agit sur un seul vendeur, provenant de --seller-id ou de votre vendeur enregistré; consultez Contexte. Si vous appartenez à plusieurs vendeurs, consultez ce problème connu : ces commandes peuvent utiliser un autre vendeur.

Commandes

Arguments

Options

game get a besoin d’au moins un des éléments title-id, --store-id ou --keyword. La valeur positionnelle est toujours un ID de titre XBOX; lorsqu’elle ressemble à un ID Store, l’erreur suggère la même commande avec --store-id :

Répertorier et rechercher

game list retourne l’ensemble du catalogue du vendeur, et game get avec --keyword effectue une recherche dans tout celui-ci. La lecture d’un catalogue volumineux peut prendre quelques minutes, et la commande affiche sa progression sur stderr. Il n’y a aucune option de pagination; paginez la sortie avec less ou more. Si une requête échoue, la commande n’affiche aucun résultat partiel et écrit l’ID de corrélation sur stderr. Chaque requête expire après deux minutes; pour changer ce délai, définissez XboxPartner:TimeoutSeconds (consultez Configuration).

Sortie

La sortie JSON est un tableau games. Chaque jeu comporte ces champs : game create et game job get écrivent le travail de création. Son champ game, avec les mêmes champs, apparaît une fois que le jeu existe.

Sortie sous forme de tableau

list et get acceptent --output table, avec une ligne par ID de titre XBOX et ces colonnes : TITLE ID, STORE IDS, PRODUCT NAME, MSA APP ID et PACKAGE FAMILY NAME. Les ID Store et les autres valeurs d’un titre partagent sa ligne, et les valeurs longues sont tronquées. create et job get refusent --output table.

Affichage détaillé

--details affiche un bloc par ID de titre, avec chaque jeu sous celui-ci et tous ses identificateurs, y compris le SCID et le sandbox de développement, sans troncature. Les valeurs manquantes s’affichent sous la forme -. Avec --details ou --output table, le nombre de résultats et la durée sont écrits sur stderr.

Créer un jeu

game create demande une confirmation avant de créer le jeu; sans terminal, elle a besoin de --confirm. La CLI ne peut pas supprimer un jeu. Si vous appartenez à plusieurs vendeurs, consultez d’abord le problème connu : le jeu pourrait être créé dans un autre vendeur. La commande envoie la requête une seule fois, attend jusqu’à deux minutes le travail de création, puis écrit le travail sur stdout. L’ID du travail, l’ID de corrélation et les commandes permettant de vérifier le travail sont écrits sur stderr. Si l’attente se termine en premier, le travail continue de s’exécuter : vérifiez-le avec game job get, et ne créez pas le jeu de nouveau. Si la requête échoue, stderr indique si un jeu pourrait avoir été créé :
  • Aucun jeu n’a été créé lorsque la requête n’a pas été envoyée, ou que le service l’a refusée, par exemple avec une erreur 400 pour un sandbox que le jeu ne peut pas utiliser. Corrigez le problème et exécutez la commande de nouveau.
  • Le résultat est inconnu après une erreur de serveur, un délai d’attente expiré ou une connexion perdue. Vérifiez game list avec la commande affichée sur stderr avant de réessayer.

Vérifier un travail de création

job get effectue seulement une lecture; vous pouvez donc l’exécuter aussi souvent que vous le voulez. Un travail qui a réussi peut tout de même signaler des problèmes dans son champ errors.

Codes de sortie

Ne vous fiez pas au code de sortie de create pour décider de l’exécuter de nouveau. Si stderr indique qu’aucun jeu n’a été créé, corrigez l’erreur et exécutez-la de nouveau; sinon, vérifiez avec la commande game job get ou game list qu’elle a affichée.

Exemple de bout en bout

Enregistrez un vendeur une fois, puis créez un jeu, qui l’utilise :
Si l’attente se termine avant le travail, vérifiez le travail au lieu de créer le jeu de nouveau. Utilisez l’ID du travail que game create a affiché sur stderr :
Une fois le travail réussi, trouvez le jeu :
Dernière modification le 19 novembre 2026