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

# Playtest

> Enumera, obtén, compara, crea, actualiza, publica y elimina los playtests de un juego de XBOX.

Un playtest permite que un grupo seleccionado de jugadores pruebe un juego antes de su lanzamiento. Los comandos `playtest` leen
los playtests de un juego en Partner Center, y los crean, actualizan, publican y eliminan. `create`,
`update`, `publish` y `delete` preguntan antes de hacer un cambio.

`create`, `update`, `publish` y `delete` son experimentales: sus opciones y su salida pueden cambiar
o quitarse. Consulta [Comandos experimentales](https://docs.xbox.com/es/tools/xbox-cli/cli-command-lifecycle.md).

## Comandos

| Comando | Descripción |
| - | - |
| `playtest list` | Enumera los playtests de un juego. |
| `playtest get <playtest-id>` | Obtiene un playtest: sus detalles, paquetes, imágenes, audiencias y `etag`. |
| `playtest diff <playtest-id>` | Compara un playtest con su última versión publicada o con otro playtest. |
| `playtest create` | Crea un playtest privado en borrador (experimental). |
| `playtest update <playtest-id>` | Cambia un playtest. Un playtest publicado vuelve a borrador (experimental). |
| `playtest publish <playtest-id>` | Publica un playtest, lo que lo ofrece a sus audiencias a partir de su fecha de inicio, y espera hasta que esté programado o activo (experimental). |
| `playtest delete <playtest-id>` | Elimina un playtest y espera hasta que se elimine (experimental). |

## Argumentos y opciones

| Argumento u opción | Se aplica a | Obligatorio | Descripción |
| - | - | - | - |
| `<playtest-id>` | `get`, `diff`, `update`, `publish`, `delete` | Sí | Un `playtestId` de `list`, como `11111111-2222-3333-4444-555555555555`. |
| `--store-id <id>` | todos | Uno de los dos | El identificador de Store del juego, como `9N0000000000`. |
| `--xbox-title-id <id>` | todos | Uno de los dos | El identificador de título de XBOX del juego, no su identificador de título de PlayFab, como `1234ABCD`. Si no coincide con ningún juego o coincide con varios, el error enumera los identificadores de Store que debes pasar en su lugar. |
| `--compare-to <playtest-id>` | `diff` | No | Otro playtest con el que comparar, en lugar de la última versión publicada. |
| `--name <name>` | `create`, `update` | `create` | El nombre del playtest, que se muestra a los jugadores. No puede estar en blanco. |
| `--description <text>` | `create`, `update` | No | Descripción breve. En `update`, `""` la borra. |
| `--long-description <text>` | `create`, `update` | No | Descripción larga. En `update`, `""` la borra. |
| `--start <date>` | `create`, `update` | `create` | Cuándo empieza el playtest. Consulta [Fechas](#dates). |
| `--end <date>` | `create`, `update` | `create` | Cuándo termina el playtest. Debe ser posterior a `--start`. |
| `--audience-id <id>` | `create`, `update` | No | Una audiencia que puede unirse, de [`audience list`](https://docs.xbox.com/es/tools/xbox-cli/commands/audience). Repítela para agregar más. Consulta [Elección de audiencias](#choosing-audiences). |
| `--pc-package-id <id>` | `create`, `update` | No | El paquete de PC que reciben los jugadores. Consulta [Paquetes](#packages). |
| `--console-package-id <id>` | `create`, `update` | No | El paquete de consola que reciben los jugadores. Consulta [Paquetes](#packages). |
| `--idempotency-key <key>` | `create` | No | De 1 a 50 caracteres ASCII imprimibles, en lugar de un GUID nuevo. Consulta [Creación de un playtest](#creating-a-playtest). |
| `--if-match <etag>` | `update` | No | Actualiza solo si el playtest todavía tiene este `etag` de `playtest get`. Consulta [Actualización de un playtest](#updating-a-playtest). |
| `--no-wait` | `publish`, `delete` | No | Vuelve en cuanto la publicación o la eliminación está en cola. No se puede combinar con `--timeout`. |
| `--timeout <duration>` | `publish`, `delete` | No | Cuánto tiempo esperar, como `90s`, `10m` o `2h`. El valor predeterminado es `5m`; como máximo, `7d`. |
| `--confirm` (`--yes`, `-y`) | `create`, `update`, `publish`, `delete` | No | Omite la solicitud de confirmación. Sin esta opción y sin un terminal, el comando se niega a hacer el cambio. |
| `--seller-id <id>` | todos | Si no está guardado | Identificador de vendedor de Partner Center. Consulta [Contexto](https://docs.xbox.com/es/tools/xbox-cli/commands/context.md). |
| `--base-url <url>` | todos | No | URL base para las solicitudes, que invalida la clave de configuración `XboxPartner:BaseUrl`. |
| `--output <format>` | todos | No | `json` (predeterminado), `json-compact` o `table`. `create`, `update`, `publish` y `delete` rechazan `table`. |

## Ejemplos

Enumera playtests, obtén uno y compara dos:

```bash theme={null}
xbox playtest list --store-id 9N0000000000
xbox playtest list --xbox-title-id 1234ABCD --output table
xbox playtest get 11111111-2222-3333-4444-555555555555 --store-id 9N0000000000
xbox playtest diff 11111111-2222-3333-4444-555555555555 --store-id 9N0000000000 --compare-to 22222222-3333-4444-5555-666666666666 --output table
```

Crea un playtest para una audiencia:

```bash theme={null}
xbox playtest create --store-id 9N0000000000 --name "Nod Arena alpha" --start 2026-11-01 --end 2026-11-15 --audience-id 1152921504606846976
```

Cambia la fecha de finalización de un playtest:

```bash theme={null}
xbox playtest update 11111111-2222-3333-4444-555555555555 --store-id 9N0000000000 --end 2026-11-30
```

Publica un playtest:

```bash theme={null}
xbox playtest publish 11111111-2222-3333-4444-555555555555 --store-id 9N0000000000
```

Elimina un playtest:

```bash theme={null}
xbox playtest delete 11111111-2222-3333-4444-555555555555 --store-id 9N0000000000
```

## Lectura de playtests

`playtest list` escribe una matriz `playtests`. Su tabla tiene las columnas `PLAYTEST ID`, `NAME`, `STATUS`, `TYPE`,
`START` y `END`. Un extracto:

```json theme={null}
{ "playtests": [ { "playtestId": "11111111-2222-3333-4444-555555555555", "name": "Alpha", "status": "Live", "type": "Private" } ] }
```

`playtest get` escribe el playtest tal como lo devuelve el servicio. `etag` es la versión que se debe pasar a
`update --if-match`, y `audiences.audienceIds` enumera las audiencias que pueden unirse. Su tabla tiene
filas `FIELD` y `VALUE`.

`playtest diff` escribe `hasDiffData`, `current` y `compared`. Cuando `hasDiffData` es `false`,
no hay nada que comparar y se omite `compared`. Su tabla muestra solo los campos que
difieren, en las columnas `FIELD`, `CURRENT` y `COMPARED`. Las imágenes no se comparan.

## Creación de un playtest

```bash theme={null}
xbox playtest create --store-id 9N0000000000 --name "Nod Arena alpha" --start 2026-11-01 --end 2026-11-15
```

`playtest create` crea un playtest privado en borrador y lo escribe como lo hace `playtest get`. Volver a ejecutarlo
crea otro playtest; quita uno que no quieras con
[`playtest delete`](#deleting-a-playtest).

Cada creación envía una clave de idempotencia, un GUID nuevo a menos que pases `--idempotency-key`. Una creación que
repite una clave devuelve el playtest que creó esa clave e ignora las opciones que difieran.

Cuando el resultado es desconocido, por ejemplo después de un tiempo de espera agotado, el comando sale con `3` e imprime un comando
que reintenta con la misma clave:

```bash theme={null}
xbox playtest create --store-id 9N0000000000 --name "Nod Arena alpha" --start 2026-11-01 --end 2026-11-15 --idempotency-key 11111111-2222-3333-4444-555555555555
```

El reintento devuelve el playtest si la primera solicitud lo creó y, de lo contrario, lo crea. Cuando una
opción contiene un salto de línea, solo se imprime la clave; ejecuta el mismo comando con
`--idempotency-key` y esa clave. Si el reintento se rechaza, por ejemplo porque la fecha de finalización ya ha pasado,
comprueba `playtest list` antes de crear el playtest con una clave nueva.

## Paquetes

Un playtest puede tener un paquete de PC y un paquete de consola. Elige un paquete que esté listo para un
playtest en [`xbox package list`](https://docs.xbox.com/es/tools/xbox-cli/commands/package#listing-packages) y pasa su `id` a la opción
de su plataforma:

```bash theme={null}
xbox playtest create --store-id 9N0000000000 --name "Nod Arena alpha" --start 2026-11-01 --end 2026-11-15 --pc-package-id 11111111-2222-3333-4444-555555555555
```

En `update`, una opción de paquete que omites conserva su paquete, un identificador nuevo lo reemplaza y `""`
lo quita:

```bash theme={null}
xbox playtest update 11111111-2222-3333-4444-555555555555 --store-id 9N0000000000 --pc-package-id 22222222-3333-4444-5555-666666666666 --console-package-id ""
```

## Actualización de un playtest

> [!WARNING]
>
> Cualquier actualización devuelve un playtest publicado a borrador, igual que si lo editas en Partner Center. Vuelve a publicarlo
> con `playtest publish` para que esté disponible para los jugadores.

```bash theme={null}
xbox playtest update 11111111-2222-3333-4444-555555555555 --store-id 9N0000000000 --end 2026-11-30
```

`playtest update` cambia solo las opciones que pasas y necesita al menos una. Escribe el playtest
actualizado como lo hace `playtest get`. Se conserva el arte del juego configurado en Partner Center; el resto del arte vinculado
al playtest se reemplaza por un marcador de posición.

Para evitar sobrescribir el cambio de otra persona, pasa el `etag` de `playtest get` en `--if-match`.
Las comillas dobles que lo rodean son opcionales, y se rechazan `*`, los etags débiles (`W/`) y las listas de etags:

```bash theme={null}
xbox playtest update 11111111-2222-3333-4444-555555555555 --store-id 9N0000000000 --end 2026-11-30 --if-match 0x8DD1234ABCD5678
```

Cuando el resultado es desconocido, el comando sale con `3`. Comprueba el playtest con `playtest get` antes
de reintentar.

## Elección de audiencias

Una audiencia es un grupo de jugadores, como evaluadores, que el vendedor administra en Partner Center.
Pasa un `id` de [`audience list`](https://docs.xbox.com/es/tools/xbox-cli/commands/audience) a `--audience-id`, y repítelo para agregar más:

```bash theme={null}
xbox playtest create --store-id 9N0000000000 --name "Nod Arena alpha" --start 2026-11-01 --end 2026-11-15 --audience-id 1152921504606846976 --audience-id 1152921504606846977
```

Sin `--audience-id`, `create` crea un playtest sin audiencias y `update` las conserva. En
`update`, los identificadores que pasas reemplazan todas las audiencias del playtest. Para quitar todas las audiencias, pasa
`""` solo:

```bash theme={null}
xbox playtest update 11111111-2222-3333-4444-555555555555 --store-id 9N0000000000 --audience-id ""
```

`""` no se puede combinar con identificadores de audiencia, y `create` lo rechaza. Un playtest necesita al menos una
audiencia para poder publicarse.

## Publicación de un playtest

Si el juego usa servicios XBOX, prepara su configuración y su embargo antes de publicar. Consulta
[Usar servicios XBOX en un playtest](https://docs.xbox.com/es/tools/xbox-cli/xbox-services-in-a-playtest.md).

```bash theme={null}
xbox playtest publish 11111111-2222-3333-4444-555555555555 --store-id 9N0000000000
```

La publicación ofrece el playtest a sus audiencias a partir de su fecha de inicio. El comando publica la
versión que lee primero; si el playtest cambia entretanto, la publicación produce un error `412` y
no cambia nada.

Antes de pedirte confirmación, el comando comprueba la configuración de servicios XBOX del juego, por ejemplo si
su fecha de embargo es posterior a la fecha de finalización del playtest, y enumera en stderr todo lo que se debe revisar. Estas
comprobaciones solo son orientativas; `--confirm` publica sin preguntar.

A continuación, el servicio ejecuta sus propias comprobaciones. Cuando una bloquea la publicación, no se pone nada en cola, y el
comando enumera cada comprobación en stderr y sale con `1`. Corrige los errores y vuelve a publicar. Un playtest
bloqueado por falta de clasificaciones por edades necesita que se complete el cuestionario de clasificación por edades en Partner Center.

Una vez que la publicación está en cola, el comando espera hasta que el playtest esté en estado `Scheduled`, `Live` o
`PublishFailed`, y lo escribe como lo hace `playtest get`. Ctrl+C deja de esperar, pero la publicación
continúa. Con `--no-wait`, el comando escribe `publishJobId` y cualquier `warnings` en cuanto la
publicación está en cola; haz su seguimiento con `playtest get`.

| Código de salida | Significado |
| - | - |
| `0` | El playtest está en estado `Scheduled` o `Live`. Con `--no-wait`, la publicación se puso en cola. |
| `1` | No se publicó, por ejemplo porque una comprobación la bloqueó o el playtest cambió. |
| `2` | La publicación produjo un error: el playtest está en estado `PublishFailed`. |
| `3` | La solicitud se envió, pero su resultado es desconocido. Comprueba el playtest con `playtest get` antes de volver a publicar. |
| `4` | La publicación se puso en cola, pero la espera terminó antes de que finalizara. Compruébala con `playtest get`. |

## Eliminación de un playtest

```bash theme={null}
xbox playtest delete 11111111-2222-3333-4444-555555555555 --store-id 9N0000000000
```

`playtest delete` elimina la versión del playtest que lee primero. Espera hasta que el playtest
esté en estado `Deleted` o haya desaparecido y, a continuación, escribe la respuesta del servicio, con `status`. Ctrl+C deja de esperar, pero
la eliminación continúa. Con `--no-wait`, escribe la respuesta en cuanto la eliminación está en cola.
Después de un `412`, es posible que la eliminación ya esté en cola, así que espera un minuto y comprueba con `playtest get`
antes de volver a eliminar.

| Código de salida | Significado |
| - | - |
| `0` | Eliminado. Con `--no-wait`, la eliminación se puso en cola. |
| `1` | No se eliminó, por ejemplo porque el playtest cambió o su estado no lo permite. |
| `3` | La solicitud se envió, pero su resultado es desconocido. Comprueba el playtest con `playtest get` antes de volver a eliminar. |
| `4` | La eliminación se puso en cola, pero el playtest no estaba en estado `Deleted` antes de que terminara la espera. Compruébalo con `playtest get`. |

## Fechas

`--start` y `--end` aceptan fechas y horas ISO 8601, como `2026-11-01T09:00:00-07:00` o
`2026-11-01T16:00:00Z`. Una fecha sin hora significa medianoche UTC, y una hora sin desplazamiento está en
UTC. Cuando una actualización pasa solo una fecha, el servicio la comprueba con la otra fecha del playtest.

## Errores

Los errores van a stderr y salen con `1`, a menos que las tablas de códigos de salida anteriores indiquen lo contrario. `create` y
`update` salen con `3` cuando su resultado es desconocido. Un error que devuelve el servicio incluye su estado
HTTP, y `--verbose` agrega la respuesta del servicio, cuyo campo `code` se muestra aquí:

| Estado | `code` | Significado |
| - | - | - |
| 400 | `invalid_playtest_request` | `create` o `update` envió una solicitud no válida, como una fecha de finalización que no es posterior a la de inicio. |
| 400 | `playtest_audience_not_found` | Un `--audience-id` no es una de las audiencias del vendedor. El mensaje muestra el comando `audience list` para comprobarlo. |
| 400 | `playtest_package_not_found` | El juego no tiene ningún paquete con ese identificador. |
| 400 | `playtest_package_ambiguous` | El identificador de paquete coincide con más de un conjunto de paquetes y ninguno está en la rama Main del juego, o con más de un grupo de mercados y ninguno es `default`. |
| 400 | `playtest_package_platform_mismatch` | Un paquete no coincide con la plataforma de su opción, como un paquete de consola en `--pc-package-id`. Comprueba su plataforma con `xbox package list`. |
| 400 | `playtest_request_rejected` | Partner Center rechazó la solicitud, como un `create` o un `update` con una fecha de finalización en el pasado o un paquete que todavía no está disponible para playtests, o un `publish` de un playtest eliminado. |
| 403 | `audience_permission_denied` | Pasaste `--audience-id` sin el permiso de lectura de grupos de clientes de Partner Center para el vendedor. No cambió nada. Pide acceso a un administrador de la cuenta de Partner Center. |
| 403 | `package_permission_denied` | En `list`, `get` y `diff`, no tienes el permiso de lectura de paquetes en el juego, que el rol de desarrollador incluye. En los demás comandos, no tienes permiso para cambiar los playtests del juego. Pide acceso a un administrador de la cuenta de Partner Center. |
| 403 | `playtest_not_enabled` | Los playtests no están habilitados para el juego y el vendedor, o el servicio no pudo comprobarlo en este momento. Si deberían estar habilitados, vuelve a intentarlo más tarde. |
| 404 | `playtest_not_found` | El juego no tiene ningún playtest con ese identificador o con el identificador de `--compare-to`. El mensaje muestra el comando `playtest list` para comprobarlo. |
| 404 | `game_not_found` | El vendedor no tiene ningún juego con ese identificador de Store. Comprueba `--store-id` y `--seller-id`. |
| 409 | `playtest_not_editable` | El estado del playtest no permite `update` en este momento, por ejemplo mientras se está publicando. Compruébalo con `playtest get`. |
| 409 | `playtest_ended` | El playtest ha terminado y `update` no pasó `--end`. Pasa un `--end` futuro con el cambio. |
| 409 | `playtest_not_publishable` | El estado del playtest no permite `publish`, o ha cambiado desde que se leyó. Compruébalo con `playtest get`. |
| 409 | `playtest_not_deletable` | El estado del playtest no permite `delete`. Compruébalo con `playtest get`. |
| 412 | `playtest_precondition_failed` | El playtest ha cambiado desde que se leyó. Para `update`, ejecuta `playtest get`, comprueba que tu cambio sigue siendo aplicable y reintenta con el nuevo `etag`. Para `publish` y `delete`, comprueba el playtest y reintenta. |
| 422 | `playtest_publish_blocked` | Las comprobaciones de publicación del servicio fallaron, por lo que no se puso nada en cola. El comando enumera cada comprobación. |

Para otros errores, el comando muestra el mensaje del servicio. Un 429 significa que enviaste demasiadas
solicitudes; espera el tiempo que indique el mensaje antes de volver a intentarlo.


## Related topics

- [Uso de Playtest](https://docs.xbox.com/es/publishing/game-publishing/concepts/playtest-preview.md)
- [Tu primer playtest](https://docs.xbox.com/es/tools/xbox-cli/first-playtest.md)
- [Información general de Playtest](https://docs.xbox.com/es/publishing/game-publishing/concepts/playtest.md)
- [Uso de servicios XBOX en un playtest](https://docs.xbox.com/es/tools/xbox-cli/xbox-services-in-a-playtest.md)
- [Opciones de pruebas previas al lanzamiento](https://docs.xbox.com/es/publishing/game-publishing/publishing-processes/managed-creators/publishing-processes-prerelease.md)
