メインコンテンツへスキップ
パッケージは、パートナー センターが受け取って処理したゲームのビルドです。package コマンドはゲームのパッケージを一覧表示および取得するため、パッケージが プレイテストの準備ができているかどうかを確認できます。パッケージをアップロードするには、パッケージのアップロードを参照してください。 これらのコマンドは試験段階 (Experimental) です。オプションと出力は変更される可能性があります。 試験段階のコマンドを参照してください。これらのコマンドには、ゲームに対するパートナー センターのパッケージの読み取り 権限が必要です。この権限は Developer ロールに含まれます。

コマンド

引数とオプション

販売者は、--seller-id または保存されている販売者から取得されます。コンテキストを参照してください。 指定がない場合、コマンドは所属している唯一の販売者を使用し、複数の販売者に所属している場合は --seller-id を求めます。 --xbox-title-id には常に販売者が必要です。

パッケージの一覧表示

package list は、ゲームの Main ブランチの ID と、サービスから返されるすべてのフィールドを含む packages 配列を 書き込みます。package get は、同じ形式でパッケージを 1 つ書き込みます。抜粋を次に示します。
次のすべての条件を満たす場合、パッケージはプレイテストの準備ができています。
  • processingState が Processed である。状態は PendingUpload から Uploaded、 Processing を経て Processed または ProcessFailed に移行します。
  • パートナー センターがパッケージの処理中に検出した問題である validationItems に、重大度が Error の 項目がない。
  • isAvailableForPlaytest が true である。
--output table には、PACKAGE ID、VERSION、PLATFORM、STATE、PLAYTEST、CREATED の 列があります。検証結果は表示されないため、JSON で validationItems を確認してください。

パッケージのアップロード

CLI はパッケージをアップロードしません。パッケージは、XBOX Game Development Kit (GDK) の makepkg を使用してアップロードします。 makepkg のリファレンスを参照してください。 継続的インテグレーション (CI) からのアップロードについては、 Package Uploader を参照してください。 その後、package list を実行して、パッケージの準備ができていることを確認します。

エラー

エラーは --output の値にかかわらず、相関 ID と共にテキストとして stderr に出力されます。--verbose を指定すると 応答本文が追加されます。失敗した場合は終了コード 1 で終了します。

例

最終更新日 2026年11月19日