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

# Juegos

> Enumera los juegos de Partner Center de un vendedor, busca uno, crea un juego y comprueba su trabajo de creación.

Los comandos `game` enumeran los juegos de Partner Center de un vendedor, buscan uno por identificador de Store, identificador de título de XBOX
o nombre, crean un juego y comprueban su trabajo de creación.

Cada comando actúa sobre un vendedor, a partir de `--seller-id` o de tu vendedor guardado; consulta
[Contexto](https://docs.xbox.com/es/tools/xbox-cli/commands/context.md). Si perteneces a varios vendedores, consulta
[este problema conocido](https://docs.xbox.com/es/tools/xbox-cli/known-issues.md#xbox-game-commands-ignore---seller-id): estos comandos pueden
usar otro vendedor.

## Comandos

| Comando | Descripción |
| - | - |
| `game list` | Enumera todos los juegos del vendedor. |
| `game get` | Obtiene juegos por identificador de Store, identificador de título de XBOX o palabra clave del nombre. |
| `game create` | Crea un juego y, después, espera a su trabajo de creación. |
| `game job get` | Lee el estado actual de un trabajo de creación de juegos. |

## Argumentos

| Argumento | Comando | Descripción |
| - | - | - |
| `[title-id]` | `get` | Un identificador de título de XBOX: de uno a ocho dígitos hexadecimales, con un prefijo `0x` opcional, como `1234ABCD`. `42` significa `0x00000042`. |
| `<job-id>` | `job get` | El identificador del trabajo de creación que imprime `game create`. |

## Opciones

| Opción | Comandos | Descripción |
| - | - | - |
| `--seller-id <id>` | todos | Identificador de vendedor de Partner Center. |
| `--base-url <url>` | todos | URL base de las solicitudes, que invalida la clave de configuración `XboxPartner:BaseUrl`. |
| `--store-id <id>` | `get` | Identificador de Microsoft Store del juego, como `9N0000000000`. Se puede combinar con `title-id` para acotar el resultado. |
| `--keyword <text>` | `get` | Busca los juegos cuyo nombre contiene este texto, sin distinguir mayúsculas de minúsculas. No se puede combinar con `title-id` ni con `--store-id`. |
| `-d`, `--details` | `list`, `get` | Muestra un bloque de texto por juego. No se puede combinar con `--output`. |
| `--name <name>` | `create` | Obligatorio. El nombre del juego. |
| `--supported-device <device>` | `create` | Obligatorio. `xbox` o `desktop`; repite la opción para ambos. |
| `--sandbox-id <id>` | `create` | El sandbox de desarrollo del juego. Debe ser un sandbox compartido existente; [`sandbox get`](https://docs.xbox.com/es/tools/xbox-cli/commands/sandbox) muestra el tipo de un sandbox. |
| `--confirm`, `--yes`, `-y` | `create` | Crea el juego sin la solicitud de confirmación. |
| `--output <format>` | todos | `json` (predeterminado) o `json-compact`; `table` solo en `list` y `get`. |

`game get` necesita al menos uno de `title-id`, `--store-id` o `--keyword`. El valor posicional es
siempre un identificador de título de XBOX; cuando parece un identificador de Store, el error sugiere el mismo comando con
`--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
```

## Enumeración y búsqueda

```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` devuelve el catálogo completo del vendedor, y `game get` con `--keyword` busca en todo
él. Leer un catálogo grande puede tardar unos minutos, y el comando muestra su
[progreso](https://docs.xbox.com/es/tools/xbox-cli/commands.md#progress) en stderr. No hay ninguna opción de paginación; pagina la salida con
`less` o `more`. Si una solicitud falla, el comando no imprime resultados parciales y escribe el
identificador de correlación en stderr. Cada solicitud agota el tiempo de espera después de dos minutos; para cambiarlo, establece
`XboxPartner:TimeoutSeconds` (consulta [Configuración](https://docs.xbox.com/es/tools/xbox-cli/configuration.md)).

## Salida

La salida JSON es una matriz `games`. Cada juego tiene estos campos:

| Campo | Descripción |
| - | - |
| `productId` | El identificador de producto de Partner Center. |
| `storeId` | El identificador de Microsoft Store. |
| `xboxTitleId` | El identificador de título de XBOX: ocho dígitos hexadecimales en mayúsculas, sin `0x`, como `"1234ABCD"`. `null` cuando el juego no tiene un identificador de título válido. |
| `SCID` | El identificador de configuración de servicio (SCID), como `"00000000-0000-0000-0000-00001234ABCD"`. La clave está en mayúsculas. `null` cuando `xboxTitleId` lo es. |
| `name` | El nombre del juego. |
| `primaryDevelopmentSandbox` | El sandbox de desarrollo del juego, o `null`. |
| `deviceFamilies` | Los dispositivos compatibles, como `["xbox", "desktop"]`. `null` o `[]` cuando no se enumera ninguno. |
| `packageIdentityName`, `packageIdentityPublisher`, `packageFamilyName` | La identidad del paquete del juego. |
| `msaAppId` | El identificador de aplicación de la cuenta Microsoft (MSA). |

`game create` y `game job get` escriben el trabajo de creación. Su campo `game`, con los mismos campos,
aparece una vez que el juego existe.

### Salida en tabla

`list` y `get` aceptan `--output table`, con una fila por identificador de título de XBOX y estas columnas:
`TITLE ID`, `STORE IDS`, `PRODUCT NAME`, `MSA APP ID` y `PACKAGE FAMILY NAME`. Los identificadores
de Store de un título y sus demás valores comparten su fila, y los valores largos se truncan. `create` y `job get`
rechazan `--output table`.

### Vista de detalles

`--details` imprime un bloque por identificador de título, con todos los juegos debajo y todos sus identificadores,
incluidos el SCID y el sandbox de desarrollo, sin truncar. Los valores que faltan se muestran como `-`. Con
`--details` o `--output table`, el número de resultados y la duración van a stderr.

## Creación de un juego

```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` pregunta antes de crear el juego; sin un terminal, necesita `--confirm`. La CLI
no puede eliminar un juego. Si perteneces a varios vendedores, consulta primero
[el problema conocido](https://docs.xbox.com/es/tools/xbox-cli/known-issues.md#xbox-game-commands-ignore---seller-id): el juego se puede
crear en otro vendedor.

El comando envía la solicitud una sola vez, espera hasta dos minutos al trabajo de creación y escribe el
trabajo en stdout. El identificador del trabajo, el identificador de correlación y los comandos para comprobar el trabajo van a stderr. Si la
espera termina antes, el trabajo sigue ejecutándose: compruébalo con `game job get` y no vuelvas a crear el
juego.

Si la solicitud falla, stderr indica si es posible que se haya creado un juego:

* **No se creó ningún juego** cuando la solicitud no se envió o el servicio la rechazó, por ejemplo con un
  `400` para un sandbox que el juego no puede usar. Corrige el problema y vuelve a ejecutar el comando.
* **El resultado es desconocido** después de un error del servidor, un tiempo de espera agotado o una conexión perdida. Comprueba
  `game list` con el comando impreso en stderr antes de volver a intentarlo.

## Comprobación de un trabajo de creación

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

`job get` solo lee, por lo que puedes ejecutarlo tantas veces como quieras. Un trabajo que se completó correctamente puede seguir
informando de problemas en su campo `errors`.

## Códigos de salida

| Código de salida | Significado |
| - | - |
| `0` | El trabajo se completó correctamente o todavía se está ejecutando. `create` también sale con `0` cuando termina su espera, por lo que `0` no garantiza que el juego exista. |
| `1` | El comando falló. En el caso de `create`, stderr indica si es posible que se haya creado un juego. |
| `2` | El trabajo terminó sin crear el juego. Consulta su campo `errors`. |
| `130` | Pulsaste Ctrl+C mientras el comando leía, o mientras `create` esperaba una respuesta a su solicitud. En el caso de `create`, stderr indica que el resultado es desconocido. |

No decidas si volver a ejecutar `create` en función de su código de salida. Si stderr indica que no se creó ningún
juego, corrige el error y vuelve a ejecutarlo; de lo contrario, compruébalo con el comando `game job get` o `game list`
que imprimió.

## Ejemplo completo

Guarda un vendedor una vez y, después, crea un juego, que lo usa:

```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
```

Si la espera termina antes que el trabajo, comprueba el trabajo en lugar de volver a crear el juego. Usa el identificador
del trabajo que `game create` imprimió en stderr:

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

Una vez que el trabajo se complete correctamente, busca el juego:

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


## Related topics

- [Configuración del juego](https://docs.xbox.com/es/publishing/game-publishing/concepts/game-setup-overview.md)
- [Enlace de juegos](https://docs.xbox.com/es/services/xbox-services/fundamentals/game-binding/index.md)
- [Certificar un juego](https://docs.xbox.com/es/publishing/game-publishing/tutorial-xbox-managed/how-to-certify-a-game.md)
- [Streaming del juego](https://docs.xbox.com/es/build/core-features/common/game-streaming/game-streaming-stream-your-game.md)
- [Juegos entre generaciones](https://docs.xbox.com/es/build/console-features/cross-gen/cross-gen-overview.md)
