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 tableaugames. 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
400pour 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 listavec 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 :game create a affiché sur stderr :
