메인 콘텐츠로 건너뛰기
game 명령은 판매자의 Partner Center 게임을 나열하고, Store ID, XBOX 타이틀 ID 또는 이름으로 게임을 조회하고, 게임을 생성하고, 생성 작업을 확인합니다. 각 명령은 --seller-id 또는 저장된 판매자에서 가져온 판매자 하나에 대해 작동합니다. 컨텍스트를 참조하세요. 여러 판매자에 속해 있다면 이 알려진 문제를 참조하세요. 이러한 명령이 다른 판매자를 사용할 수 있습니다.

명령

인수

옵션

game get에는 title-id, --store-id, --keyword 중 하나 이상이 필요합니다. 위치 값은 항상 XBOX 타이틀 ID이며, 값이 Store ID처럼 보이면 오류에 --store-id를 사용하는 같은 명령이 제안됩니다.

나열 및 조회

game list는 판매자의 전체 카탈로그를 반환하며, --keyword를 사용한 game get은 전체 카탈로그를 검색합니다. 카탈로그가 크면 읽는 데 몇 분이 걸릴 수 있으며, 명령은 stderr에 진행률을 표시합니다. 페이징 옵션은 없으므로 less 또는 more로 출력을 페이지 단위로 보세요. 요청이 실패하면 명령은 부분 결과를 출력하지 않고 상관 관계 ID를 stderr에 씁니다. 각 요청은 2분 후에 시간 초과됩니다. 이를 변경하려면 XboxPartner:TimeoutSeconds를 설정하세요 (구성 참조).

출력

JSON 출력은 games 배열 하나입니다. 각 게임에는 다음 필드가 있습니다. game create와 game job get은 생성 작업을 씁니다. 같은 필드를 가진 작업의 game 필드는 게임이 존재하게 되면 나타납니다.

테이블 출력

list와 get은 --output table을 허용하며, XBOX 타이틀 ID마다 한 행과 TITLE ID, STORE IDS, PRODUCT NAME, MSA APP ID, PACKAGE FAMILY NAME 열을 표시합니다. 타이틀의 Store ID와 기타 값은 같은 행에 표시되며, 긴 값은 잘립니다. create와 job get은 --output table을 거부합니다.

세부 정보 보기

--details는 타이틀 ID마다 블록 하나를 출력하며, 그 아래에 모든 게임과 SCID 및 개발 샌드박스를 포함한 모든 식별자를 잘림 없이 표시합니다. 누락된 값은 -로 표시됩니다. --details 또는 --output table을 사용하면 결과 수와 소요 시간이 stderr로 출력됩니다.

게임 생성

game create는 게임을 생성하기 전에 묻습니다. 터미널이 없으면 --confirm이 필요합니다. CLI는 게임을 삭제할 수 없습니다. 여러 판매자에 속해 있다면 먼저 알려진 문제를 확인하세요. 게임이 다른 판매자에 생성될 수 있습니다. 이 명령은 요청을 한 번 보내고, 생성 작업을 최대 2분 동안 기다린 다음, 작업을 stdout에 씁니다. 작업 ID, 상관 관계 ID 및 작업을 확인하는 명령은 stderr로 출력됩니다. 작업보다 대기가 먼저 끝나면 작업은 계속 실행됩니다. game job get으로 확인하고, 게임을 다시 생성하지 마세요. 요청이 실패하면 stderr에 게임이 생성되었을 가능성이 있는지가 표시됩니다.
  • 요청이 전송되지 않았거나 서비스가 요청을 거부한 경우(예: 게임이 사용할 수 없는 샌드박스에 대한 400) 게임이 생성되지 않았습니다. 문제를 해결하고 명령을 다시 실행하세요.
  • 서버 오류, 시간 초과 또는 연결 끊김 이후에는 결과를 알 수 없습니다. 다시 시도하기 전에 stderr에 출력된 명령으로 game list를 확인하세요.

생성 작업 확인

job get은 읽기만 하므로 원하는 만큼 자주 실행할 수 있습니다. 성공한 작업도 errors 필드에 문제를 보고할 수 있습니다.

종료 코드

종료 코드로 create를 다시 실행할지 결정하지 마세요. stderr에 게임이 생성되지 않았다고 표시되면 오류를 해결하고 다시 실행하세요. 그렇지 않으면 출력된 game job get 또는 game list 명령으로 확인하세요.

엔드투엔드 예제

판매자를 한 번 저장한 다음, 해당 판매자를 사용하는 게임을 생성합니다.
작업보다 대기가 먼저 끝나면 게임을 다시 생성하는 대신 작업을 확인하세요. game create가 stderr에 출력한 작업 ID를 사용합니다.
작업이 성공하면 게임을 찾습니다.
마지막 수정일 2026년 11월 19일