game コマンドは、販売者のパートナー センターのゲームを一覧表示し、Store ID、XBOX タイトル ID、
または名前でゲームを検索し、ゲームを作成して、その作成ジョブを確認します。
各コマンドは、--seller-id または保存されている販売者で指定された 1 つの販売者を対象に動作します。
コンテキストを参照してください。複数の販売者に所属している場合は、
こちらの既知の問題を参照してください。これらのコマンドが
別の販売者を使用する場合があります。
コマンド
引数
オプション
game get には、title-id、--store-id、--keyword のうち少なくとも 1 つが必要です。位置指定の値は
常に XBOX タイトル ID です。値が Store ID のように見える場合、エラーには --store-id を使用した同じコマンドが
提案されます。
一覧表示と検索
game list は販売者のカタログ全体を返し、--keyword を指定した game get はカタログ全体を検索します。
カタログが大きい場合は読み取りに数分かかることがあり、コマンドは stderr に
進行状況を表示します。ページングのオプションはありません。出力をページ単位で表示するには
less または more を使用します。要求が失敗した場合、コマンドは部分的な結果を出力せず、
相関 ID を stderr に書き込みます。各要求は 2 分後にタイムアウトします。この値を変更するには、
XboxPartner:TimeoutSeconds を設定します (構成を参照)。
出力
JSON 出力は 1 つのgames 配列です。各ゲームには次のフィールドがあります。
game create と game job get は作成ジョブを書き込みます。ジョブの game フィールドには同じフィールドが含まれ、
ゲームが作成されると表示されます。
表形式の出力
list と get は --output table を受け付け、XBOX タイトル ID ごとに 1 行を、次の列で表示します。
TITLE ID、STORE IDS、PRODUCT NAME、MSA APP ID、PACKAGE FAMILY NAME。タイトルの
Store ID とその他の値は同じ行に表示され、長い値は切り詰められます。create と job get は
--output table を拒否します。
詳細ビュー
--details は、タイトル ID ごとに 1 つのブロックを出力します。各ブロックには、そのタイトル ID のすべてのゲームと、SCID や開発用サンドボックスを含む
すべての識別子が、切り詰められずに表示されます。値がない場合は - と表示されます。
--details または --output table を指定すると、結果の件数と所要時間は stderr に出力されます。
ゲームの作成
game create はゲームを作成する前に確認を求めます。ターミナルがない場合は --confirm が必要です。CLI では
ゲームを削除できません。複数の販売者に所属している場合は、最初に
既知の問題を確認してください。ゲームが
別の販売者に作成される可能性があります。
このコマンドは要求を 1 回送信し、作成ジョブを最大 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 を使用します。
