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 matrizgames. 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
400para 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 listcom 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á:game create imprimiu em stderr:
