メインコンテンツへスキップ
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 を使用します。
ジョブが成功したら、ゲームを検索します。
最終更新日 2026年11月19日