> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# パッケージ

> パートナー センターのゲームのパッケージを一覧表示および取得し、ビルドをプレイテストで使用できるかどうかを確認して、パッケージのアップロード方法を確認します。

パッケージは、パートナー センターが受け取って処理したゲームのビルドです。`package`
コマンドはゲームのパッケージを一覧表示および取得するため、パッケージが
[プレイテスト](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/playtest.md)の準備ができているかどうかを確認できます。パッケージをアップロードするには、[パッケージのアップロード](#uploading-packages)を参照してください。

これらのコマンドは試験段階 (Experimental) です。オプションと出力は変更される可能性があります。
[試験段階のコマンド](https://docs.xbox.com/ja-jp/tools/xbox-cli/cli-command-lifecycle.md)を参照してください。これらのコマンドには、ゲームに対するパートナー センターのパッケージの読み取り
権限が必要です。この権限は Developer ロールに含まれます。

## コマンド

| コマンド | 説明 |
| - | - |
| `package list` | ゲームの Main ブランチにあるパッケージを一覧表示します。 |
| `package get <package-id>` | パッケージを 1 つ取得します。 |

## 引数とオプション

| 引数またはオプション | 適用対象 | 必須 | 説明 |
| - | - | - | - |
| `<package-id>` | `get` | はい | `package list` から取得したパッケージ ID。 |
| `--store-id <id>` | すべて | 2 つのうちいずれか | ゲームの Store ID (`9N0000000000` など)。 |
| `--xbox-title-id <id>` | すべて | 2 つのうちいずれか | ゲームの XBOX タイトル ID (`1234ABCD` など)。PlayFab タイトル ID ではありません。タイトル ID に複数のゲームがある場合、コマンドは `--store-id` を求めます。 |
| `--seller-id <id>` | すべて | いいえ | パートナー センターの販売者 ID。 |
| `--base-url <url>` | すべて | いいえ | 要求のベース URL。`XboxPartner:BaseUrl` 構成キーをオーバーライドします。 |
| `--output <format>` | すべて | いいえ | `json` (既定)、`json-compact`、または `table`。 |

販売者は、`--seller-id` または保存されている販売者から取得されます。[コンテキスト](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/context.md)を参照してください。
指定がない場合、コマンドは所属している唯一の販売者を使用し、複数の販売者に所属している場合は `--seller-id` を求めます。
`--xbox-title-id` には常に販売者が必要です。

## パッケージの一覧表示

```bash theme={null}
xbox package list --store-id 9N0000000000 --output json-compact
```

`package list` は、ゲームの Main ブランチの ID と、サービスから返されるすべてのフィールドを含む `packages` 配列を
書き込みます。`package get` は、同じ形式でパッケージを 1 つ書き込みます。抜粋を次に示します。

```json theme={null}
{
  "packageSetId": "22222222-3333-4444-5555-666666666666",
  "packages": [
    {
      "id": "11111111-2222-3333-4444-555555555555",
      "version": "1.0.0.0",
      "platform": "PC",
      "packageType": "Msixvc",
      "processingState": "Processed",
      "isAvailableForPlaytest": true,
      "validationItems": [],
      "fileName": "Nod.Arena_1.0.0.0_x64.msixvc",
      "createdAt": "2026-11-04T18:00:00Z"
    }
  ]
}
```

次のすべての条件を満たす場合、パッケージはプレイテストの準備ができています。

* `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 のリファレンス](https://learn.microsoft.com/gaming/gdk/docs/features/common/packaging/deployment/makepkg)を参照してください。
継続的インテグレーション (CI) からのアップロードについては、
[Package Uploader](https://learn.microsoft.com/gaming/gdk/docs/features/common/packaging/package-uploader) を参照してください。
その後、`package list` を実行して、パッケージの準備ができていることを確認します。

## エラー

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

| エラー | 対処方法 |
| - | - |
| HTTP 401 | `xbox auth login` でもう一度サインインします。 |
| HTTP 403、`package_permission_denied` | この販売者のゲームに対するパッケージの読み取り権限がありません。パートナー センター アカウントのマネージャーに Developer ロールを依頼するか、ゲームが別の販売者に属している場合は `--seller-id` を渡します。 |
| HTTP 403、`identity_override_not_authorized` | その販売者に所属していません。販売者を確認し、`xbox seller list` で自分の販売者を確認します。 |
| HTTP 400、`seller_selection_required` | 複数の販売者に所属しています。`--seller-id` を渡します。 |
| HTTP 404、`game_not_found` | 販売者にその Store ID のゲームがありません。`--store-id` と `--seller-id` を確認します。 |

## 例

```bash theme={null}
xbox package list --store-id 9N0000000000
xbox package list --xbox-title-id 1234ABCD --seller-id 1234567 --output table
xbox package get 11111111-2222-3333-4444-555555555555 --store-id 9N0000000000
```


## Related topics

- [パッケージ](https://docs.xbox.com/ja-jp/publishing/game-publishing/concepts/game-package-management.md)
- [Publisher Content パッケージ](https://docs.xbox.com/ja-jp/build/core-features/common/packaging/packaging-publisher-content.md)
- [パッケージング (目次)](https://docs.xbox.com/ja-jp/build/core-features/common/packaging/gc-packaging-toc.md)
- [パッケージングの概要](https://docs.xbox.com/ja-jp/build/core-features/common/packaging/overviews/packaging.md)
- [ゲーム パッケージ用パッケージ フライトを構成する方法](https://docs.xbox.com/ja-jp/publishing/game-publishing/how-to/how-to-package-flights-for-xvc-packages.md)
