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, issu 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 l’un des éléments suivants : 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 :

Liste et recherche

game list renvoie l’intégralité du catalogue du vendeur, et game get avec --keyword effectue une recherche dans tout ce catalogue. La lecture d’un catalogue volumineux peut prendre quelques minutes, et la commande affiche sa progression sur stderr. Il n’existe pas d’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 au bout de deux minutes ; pour modifier 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 d’un titre et ses autres valeurs partagent sa ligne, et les valeurs longues sont tronquées. create et job get refusent --output table.

Vue détaillée

--details affiche un bloc par ID de titre, avec chaque jeu associé 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éation d’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 peut être créé chez 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 de nouveau le jeu. Si la requête échoue, stderr indique si un jeu a pu être 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 de nouveau la commande.
  • Le résultat est inconnu après une erreur de serveur, l’expiration d’un délai d’attente ou une perte de connexion. Vérifiez game list avec la commande affichée sur stderr avant de réessayer.

Vérification d’un travail de création

job get effectue uniquement des lectures : vous pouvez donc l’exécuter aussi souvent que vous le souhaitez. 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 de nouveau le jeu. Utilisez l’ID du travail que game create a affiché sur stderr :
Une fois le travail réussi, recherchez le jeu :
Dernière modification le 19 novembre 2026