> ## 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.

# ゲーム

> 販売者のパートナー センターのゲームを一覧表示して検索し、ゲームを作成して、その作成ジョブを確認します。

`game` コマンドは、販売者のパートナー センターのゲームを一覧表示し、Store ID、XBOX タイトル ID、
または名前でゲームを検索し、ゲームを作成して、その作成ジョブを確認します。

各コマンドは、`--seller-id` または保存されている販売者で指定された 1 つの販売者を対象に動作します。
[コンテキスト](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/context.md)を参照してください。複数の販売者に所属している場合は、
[こちらの既知の問題](https://docs.xbox.com/ja-jp/tools/xbox-cli/known-issues.md#xbox-game-commands-ignore---seller-id)を参照してください。これらのコマンドが
別の販売者を使用する場合があります。

## コマンド

| コマンド | 説明 |
| - | - |
| `game list` | 販売者のすべてのゲームを一覧表示します。 |
| `game get` | Store ID、XBOX タイトル ID、または名前のキーワードでゲームを取得します。 |
| `game create` | ゲームを作成し、その作成ジョブを待機します。 |
| `game job get` | ゲーム作成ジョブの現在の状態を読み取ります。 |

## 引数

| 引数 | コマンド | 説明 |
| - | - | - |
| `[title-id]` | `get` | XBOX タイトル ID。1 ～ 8 桁の 16 進数で、省略可能な `0x` プレフィックスを付けることができます (`1234ABCD` など)。`42` は `0x00000042` を意味します。 |
| `<job-id>` | `job get` | `game create` によって出力される作成ジョブ ID。 |

## オプション

| オプション | コマンド | 説明 |
| - | - | - |
| `--seller-id <id>` | すべて | パートナー センターの販売者 ID。 |
| `--base-url <url>` | すべて | 要求のベース URL。`XboxPartner:BaseUrl` 構成キーをオーバーライドします。 |
| `--store-id <id>` | `get` | ゲームの Microsoft Store ID (`9N0000000000` など)。`title-id` と組み合わせて結果を絞り込むことができます。 |
| `--keyword <text>` | `get` | 名前にこのテキストが含まれるゲームを検索します。大文字と小文字は区別されません。`title-id` または `--store-id` と組み合わせることはできません。 |
| `-d`、`--details` | `list`、`get` | ゲームごとに 1 つのテキスト ブロックを表示します。`--output` と組み合わせることはできません。 |
| `--name <name>` | `create` | 必須。ゲームの名前。 |
| `--supported-device <device>` | `create` | 必須。`xbox` または `desktop`。両方を指定するにはオプションを繰り返します。 |
| `--sandbox-id <id>` | `create` | ゲームの開発用サンドボックス。既存の Shared サンドボックスである必要があります。サンドボックスの種類は [`sandbox get`](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/sandbox) で確認できます。 |
| `--confirm`、`--yes`、`-y` | `create` | 確認プロンプトなしでゲームを作成します。 |
| `--output <format>` | すべて | `json` (既定) または `json-compact`。`table` は `list` と `get` でのみ使用できます。 |

`game get` には、`title-id`、`--store-id`、`--keyword` のうち少なくとも 1 つが必要です。位置指定の値は
常に XBOX タイトル ID です。値が Store ID のように見える場合、エラーには `--store-id` を使用した同じコマンドが
提案されます。

```text theme={null}
title-id must be one to eight hexadecimal digits, with an optional 0x prefix. 9N0000000000 looks like a Store ID. Did you mean:
  xbox game get --store-id 9N0000000000 --seller-id 1234567
```

## 一覧表示と検索

```bash theme={null}
xbox game list --output table
xbox game get --store-id 9N0000000000
xbox game get 1234ABCD --details
xbox game get --keyword "nod arena" --output table
```

`game list` は販売者のカタログ全体を返し、`--keyword` を指定した `game get` はカタログ全体を検索します。
カタログが大きい場合は読み取りに数分かかることがあり、コマンドは stderr に
[進行状況](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands.md#progress)を表示します。ページングのオプションはありません。出力をページ単位で表示するには
`less` または `more` を使用します。要求が失敗した場合、コマンドは部分的な結果を出力せず、
相関 ID を stderr に書き込みます。各要求は 2 分後にタイムアウトします。この値を変更するには、
`XboxPartner:TimeoutSeconds` を設定します ([構成](https://docs.xbox.com/ja-jp/tools/xbox-cli/configuration.md)を参照)。

## 出力

JSON 出力は 1 つの `games` 配列です。各ゲームには次のフィールドがあります。

| フィールド | 説明 |
| - | - |
| `productId` | パートナー センターの製品 ID。 |
| `storeId` | Microsoft Store ID。 |
| `xboxTitleId` | XBOX タイトル ID。`0x` を除いた 8 桁の大文字の 16 進数です (`"1234ABCD"` など)。ゲームに有効なタイトル ID がない場合は `null`。 |
| `SCID` | サービス構成識別子 (SCID) (`"00000000-0000-0000-0000-00001234ABCD"` など)。キーは大文字です。`xboxTitleId` が `null` の場合は `null`。 |
| `name` | ゲームの名前。 |
| `primaryDevelopmentSandbox` | ゲームの開発用サンドボックス、または `null`。 |
| `deviceFamilies` | サポートされているデバイス (`["xbox", "desktop"]` など)。一覧に何もない場合は `null` または `[]`。 |
| `packageIdentityName`、`packageIdentityPublisher`、`packageFamilyName` | ゲームのパッケージ ID。 |
| `msaAppId` | Microsoft アカウント (MSA) のアプリ ID。 |

`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 に出力されます。

## ゲームの作成

```bash theme={null}
xbox game create --name "Nod Arena" \
  --supported-device xbox --supported-device desktop \
  --sandbox-id TESTSB.42 --seller-id 1234567 --confirm
```

`game create` はゲームを作成する前に確認を求めます。ターミナルがない場合は `--confirm` が必要です。CLI では
ゲームを削除できません。複数の販売者に所属している場合は、最初に
[既知の問題](https://docs.xbox.com/ja-jp/tools/xbox-cli/known-issues.md#xbox-game-commands-ignore---seller-id)を確認してください。ゲームが
別の販売者に作成される可能性があります。

このコマンドは要求を 1 回送信し、作成ジョブを最大 2 分間待機してから、ジョブを
stdout に書き込みます。ジョブ ID、相関 ID、およびジョブを確認するためのコマンドは stderr に出力されます。ジョブより先に
待機が終了した場合でも、ジョブは引き続き実行されます。`game job get` でジョブを確認し、ゲームを再度
作成しないでください。

要求が失敗した場合、ゲームが作成された可能性があるかどうかが stderr に示されます。

* **ゲームは作成されていません**: 要求が送信されなかった場合、またはサービスが要求を拒否した場合 (ゲームが使用できないサンドボックスに対する
  `400` など) です。問題を修正してから、コマンドを再実行してください。
* **結果は不明です**: サーバー エラー、タイムアウト、または接続の切断の後です。再試行する前に、
  stderr に出力されたコマンドで `game list` を確認してください。

## 作成ジョブの確認

```bash theme={null}
xbox game job get 11111111-2222-3333-4444-555555555555 --output json-compact
```

`job get` は読み取りのみを行うため、何度でも実行できます。成功したジョブでも、
`errors` フィールドで問題が報告される場合があります。

## 終了コード

| 終了コード | 意味 |
| - | - |
| `0` | ジョブは成功したか、まだ実行中です。`create` は待機が終了したときにも `0` で終了するため、`0` はゲームが存在することを保証しません。 |
| `1` | コマンドは失敗しました。`create` の場合は、ゲームが作成された可能性があるかどうかが stderr に示されます。 |
| `2` | ジョブはゲームを作成せずに終了しました。ジョブの `errors` フィールドを確認してください。 |
| `130` | コマンドの読み取り中、または `create` が要求への応答を待機している間に Ctrl+C キーを押しました。`create` の場合は、結果が不明であることが stderr に示されます。 |

`create` を再実行するかどうかを終了コードで判断しないでください。ゲームが作成されていないと stderr に
示されている場合は、エラーを修正して再実行します。それ以外の場合は、出力された `game job get` または `game list`
コマンドで確認してください。

## エンド ツー エンドの例

販売者を一度保存してから、その販売者を使用するゲームを作成します。

```bash theme={null}
xbox context set seller-id 1234567

xbox game create --name "Nod Arena" \
  --supported-device xbox --supported-device desktop \
  --sandbox-id TESTSB.42 --confirm
```

ジョブより先に待機が終了した場合は、ゲームを再度作成するのではなく、ジョブを確認します。`game create` が
stderr に出力したジョブ ID を使用します。

```bash theme={null}
xbox game job get 11111111-2222-3333-4444-555555555555 --output json-compact
```

ジョブが成功したら、ゲームを検索します。

```bash theme={null}
xbox game get --keyword "Nod Arena" --output table
```


## Related topics

- [ゲーム セーブ](https://docs.xbox.com/ja-jp/build/core-features/common/game-save/index.md)
- [XBOX ゲーム開発](https://docs.xbox.com/ja-jp/index.md)
- [XBOX ゲーム プレビュー](https://docs.xbox.com/ja-jp/publishing/game-publishing/publishing-processes/managed-creators/publishing-processes-xbox-game-preview.md)
- [ゲームのゲーム メタデータを構成する](https://docs.xbox.com/ja-jp/publishing/game-publishing/tutorial-xbox-managed/how-to-add-metadata.md)
- [PC ゲームの登録](https://docs.xbox.com/ja-jp/tools/tools-pc/title-registration-pc.md)
