Saltar al contenido principal
Los comandos 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 matriz games. 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 400 para 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 list con 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:
Si la espera termina antes que el trabajo, comprueba el trabajo en lugar de volver a crear el juego. Usa el identificador del trabajo que game create imprimió en stderr:
Una vez que el trabajo se complete correctamente, busca el juego:
Última modificación el 19 de noviembre de 2026