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