game enumeran los juegos de Partner Center de un vendedor, buscan uno por identificador de Store, identificador de título de XBOX
o nombre, crean un juego y comprueban su trabajo de creación.
Cada comando actúa sobre un vendedor, a partir de --seller-id o de tu vendedor guardado; consulta
Contexto. Si perteneces a varios vendedores, consulta
este problema conocido: estos comandos pueden
usar otro vendedor.
Comandos
Argumentos
Opciones
game get necesita al menos uno de title-id, --store-id o --keyword. El valor posicional es
siempre un identificador de título de XBOX; cuando parece un identificador de Store, el error sugiere el mismo comando con
--store-id:
Enumeración y búsqueda
game list devuelve el catálogo completo del vendedor, y game get con --keyword busca en todo
él. Leer un catálogo grande puede tardar unos minutos, y el comando muestra su
progreso en stderr. No hay ninguna opción de paginación; pagina la salida con
less o more. Si una solicitud falla, el comando no imprime resultados parciales y escribe el
identificador de correlación en stderr. Cada solicitud agota el tiempo de espera después de dos minutos; para cambiarlo, establece
XboxPartner:TimeoutSeconds (consulta Configuración).
Salida
La salida JSON es una matrizgames. Cada juego tiene estos campos:
game create y game job get escriben el trabajo de creación. Su campo game, con los mismos campos,
aparece una vez que el juego existe.
Salida en tabla
list y get aceptan --output table, con una fila por identificador de título de XBOX y estas columnas:
TITLE ID, STORE IDS, PRODUCT NAME, MSA APP ID y PACKAGE FAMILY NAME. Los identificadores
de Store de un título y sus demás valores comparten su fila, y los valores largos se truncan. create y job get
rechazan --output table.
Vista de detalles
--details imprime un bloque por identificador de título, con todos los juegos debajo y todos sus identificadores,
incluidos el SCID y el sandbox de desarrollo, sin truncar. Los valores que faltan se muestran como -. Con
--details o --output table, el número de resultados y la duración van a stderr.
Creación de un juego
game create pregunta antes de crear el juego; sin un terminal, necesita --confirm. La CLI
no puede eliminar un juego. Si perteneces a varios vendedores, consulta primero
el problema conocido: el juego se puede
crear en otro vendedor.
El comando envía la solicitud una sola vez, espera hasta dos minutos al trabajo de creación y escribe el
trabajo en stdout. El identificador del trabajo, el identificador de correlación y los comandos para comprobar el trabajo van a stderr. Si la
espera termina antes, el trabajo sigue ejecutándose: compruébalo con game job get y no vuelvas a crear el
juego.
Si la solicitud falla, stderr indica si es posible que se haya creado un juego:
- No se creó ningún juego cuando la solicitud no se envió o el servicio la rechazó, por ejemplo con un
400para un sandbox que el juego no puede usar. Corrige el problema y vuelve a ejecutar el comando. - El resultado es desconocido después de un error del servidor, un tiempo de espera agotado o una conexión perdida. Comprueba
game listcon el comando impreso en stderr antes de volver a intentarlo.
Comprobación de un trabajo de creación
job get solo lee, por lo que puedes ejecutarlo tantas veces como quieras. Un trabajo que se completó correctamente puede seguir
informando de problemas en su campo errors.
Códigos de salida
No decidas si volver a ejecutar
create en función de su código de salida. Si stderr indica que no se creó ningún
juego, corrige el error y vuelve a ejecutarlo; de lo contrario, compruébalo con el comando game job get o game list
que imprimió.
Ejemplo completo
Guarda un vendedor una vez y, después, crea un juego, que lo usa:game create imprimió en stderr:
