Pular para o conteúdo principal
Os comandos game listam os jogos de um vendedor no Partner Center, consultam um jogo pela ID da Store, pela ID de título do XBOX ou pelo nome, criam um jogo e verificam o trabalho de criação dele. Cada comando atua em um vendedor, de --seller-id ou do vendedor salvo; consulte Contexto. Se você pertencer a vários vendedores, consulte este problema conhecido: esses comandos podem usar outro vendedor.

Comandos

Argumentos

Opções

game get precisa de pelo menos um entre title-id, --store-id ou --keyword. O valor posicional é sempre uma ID de título do XBOX; quando ele parece uma ID da Store, o erro sugere o mesmo comando com --store-id:

Listagem e consulta

game list retorna o catálogo inteiro do vendedor, e game get com --keyword pesquisa todo ele. A leitura de um catálogo grande pode levar alguns minutos, e o comando mostra seu progresso em stderr. Não há opção de paginação; pagine a saída com less ou more. Se uma solicitação falhar, o comando não imprime resultados parciais e grava a ID de correlação em stderr. Cada solicitação atinge o tempo limite após dois minutos; para alterá-lo, defina XboxPartner:TimeoutSeconds (consulte Configuração).

Saída

A saída JSON é uma matriz games. Cada jogo tem estes campos: game create e game job get gravam o trabalho de criação. O campo game dele, com os mesmos campos, aparece assim que o jogo existe.

Saída em tabela

list e get aceitam --output table, com uma linha por ID de título do XBOX e estas colunas: TITLE ID, STORE IDS, PRODUCT NAME, MSA APP ID e PACKAGE FAMILY NAME. As IDs da Store e os outros valores de um título compartilham a linha dele, e os valores longos são truncados. create e job get recusam --output table.

Exibição de detalhes

--details imprime um bloco por ID de título, com todos os jogos abaixo dela e todos os seus identificadores, incluindo o SCID e a sandbox de desenvolvimento, sem truncar. Os valores ausentes aparecem como -. Com --details ou --output table, a contagem de resultados e a duração vão para stderr.

Criar um jogo

game create pergunta antes de criar o jogo; sem um terminal, ele precisa de --confirm. A CLI não pode excluir um jogo. Se você pertencer a vários vendedores, verifique o problema conhecido primeiro: o jogo pode ser criado em outro vendedor. O comando envia a solicitação uma única vez, aguarda até dois minutos pelo trabalho de criação e grava o trabalho em stdout. A ID do trabalho, a ID de correlação e os comandos para verificar o trabalho vão para stderr. Se a espera terminar primeiro, o trabalho continuará em execução: verifique-o com game job get e não crie o jogo novamente. Se a solicitação falhar, stderr informará se um jogo pode ter sido criado:
  • Nenhum jogo foi criado quando a solicitação não foi enviada ou quando o serviço a recusou, por exemplo, com um 400 para uma sandbox que o jogo não pode usar. Corrija o problema e execute o comando novamente.
  • O resultado é desconhecido após um erro do servidor, um tempo limite ou uma conexão perdida. Verifique game list com o comando impresso em stderr antes de tentar novamente.

Verificar um trabalho de criação

job get apenas lê; portanto, você pode executá-lo quantas vezes quiser. Um trabalho bem-sucedido ainda pode relatar problemas no campo errors.

Códigos de saída

Não decida se deve executar create novamente com base no código de saída. Se stderr informar que nenhum jogo foi criado, corrija o erro e execute-o novamente; caso contrário, verifique com o comando game job get ou game list que ele imprimiu.

Exemplo completo

Salve um vendedor uma vez e, em seguida, crie um jogo, que o usará:
Se a espera terminar antes do trabalho, verifique o trabalho em vez de criar o jogo novamente. Use a ID do trabalho que game create imprimiu em stderr:
Depois que o trabalho for bem-sucedido, encontre o jogo:
Última modificação em 19 de novembro de 2026