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를 사용합니다.
