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

> Répertoriez, obtenez, comparez, créez, mettez à jour, publiez et supprimez les tests de jeu d'un jeu XBOX.

Un test de jeu permet à un groupe choisi de joueurs d'essayer un jeu avant sa sortie. Les commandes `playtest` lisent
les tests de jeu d'un jeu dans Partner Center, et les créent, les mettent à jour, les publient et les suppriment. `create`,
`update`, `publish` et `delete` demandent une confirmation avant d'apporter une modification.

`create`, `update`, `publish` et `delete` sont expérimentales : leurs options et leur sortie pourraient changer
ou être retirées. Consultez [Commandes expérimentales](https://docs.xbox.com/fr-CA/tools/xbox-cli/cli-command-lifecycle.md).

## Commandes

| Commande | Description |
| - | - |
| `playtest list` | Répertorie les tests de jeu d'un jeu. |
| `playtest get <playtest-id>` | Obtient un test de jeu : ses détails, ses packages, ses images, ses publics et son `etag`. |
| `playtest diff <playtest-id>` | Compare un test de jeu avec sa dernière version publiée, ou avec un autre test de jeu. |
| `playtest create` | Crée un test de jeu privé à l'état de brouillon (expérimentale). |
| `playtest update <playtest-id>` | Modifie un test de jeu. Un test de jeu publié revient à l'état de brouillon (expérimentale). |
| `playtest publish <playtest-id>` | Publie un test de jeu, ce qui l'offre à ses publics à partir de sa date de début, et attend qu'il soit planifié ou en ligne (expérimentale). |
| `playtest delete <playtest-id>` | Supprime un test de jeu, et attend qu'il soit supprimé (expérimentale). |

## Arguments et options

| Argument ou option | S'applique à | Obligatoire | Description |
| - | - | - | - |
| `<playtest-id>` | `get`, `diff`, `update`, `publish`, `delete` | Oui | Un `playtestId` provenant de `list`, comme `11111111-2222-3333-4444-555555555555`. |
| `--store-id <id>` | toutes | L'une des deux | Le Store ID du jeu, comme `9N0000000000`. |
| `--xbox-title-id <id>` | toutes | L'une des deux | L'ID de titre XBOX du jeu, et non son ID de titre PlayFab, comme `1234ABCD`. S'il ne correspond à aucun jeu ou à plusieurs, l'erreur répertorie les Store ID à transmettre à la place. |
| `--compare-to <playtest-id>` | `diff` | Non | Un autre test de jeu avec lequel comparer, au lieu de la dernière version publiée. |
| `--name <name>` | `create`, `update` | `create` | Le nom du test de jeu, affiché aux joueurs. Ne peut pas être vide. |
| `--description <text>` | `create`, `update` | Non | Description courte. Avec `update`, `""` l'efface. |
| `--long-description <text>` | `create`, `update` | Non | Description longue. Avec `update`, `""` l'efface. |
| `--start <date>` | `create`, `update` | `create` | Moment où le test de jeu commence. Consultez [Dates](#dates). |
| `--end <date>` | `create`, `update` | `create` | Moment où le test de jeu se termine. Doit être postérieur à `--start`. |
| `--audience-id <id>` | `create`, `update` | Non | Un public qui peut participer, provenant de [`audience list`](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/audience). Répétez l'option pour en ajouter d'autres. Consultez [Choisir les publics](#choosing-audiences). |
| `--pc-package-id <id>` | `create`, `update` | Non | Le package PC que les joueurs obtiennent. Consultez [Packages](#packages). |
| `--console-package-id <id>` | `create`, `update` | Non | Le package pour console que les joueurs obtiennent. Consultez [Packages](#packages). |
| `--idempotency-key <key>` | `create` | Non | De 1 à 50 caractères ASCII imprimables, au lieu d'un nouveau GUID. Consultez [Créer un test de jeu](#creating-a-playtest). |
| `--if-match <etag>` | `update` | Non | Effectue la mise à jour seulement si le test de jeu a toujours cet `etag` provenant de `playtest get`. Consultez [Mettre à jour un test de jeu](#updating-a-playtest). |
| `--no-wait` | `publish`, `delete` | Non | Retourne dès que la publication ou la suppression est mise en file d'attente. Ne peut pas être combinée avec `--timeout`. |
| `--timeout <duration>` | `publish`, `delete` | Non | Durée d'attente, comme `90s`, `10m` ou `2h`. Valeur par défaut : `5m`; au maximum `7d`. |
| `--confirm` (`--yes`, `-y`) | `create`, `update`, `publish`, `delete` | Non | Ignore l'invite de confirmation. Sans cette option et sans terminal, la commande refuse d'apporter la modification. |
| `--seller-id <id>` | toutes | Si elle n'est pas enregistrée | ID de vendeur Partner Center. Consultez [Contexte](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/context.md). |
| `--base-url <url>` | toutes | Non | URL de base des requêtes, qui remplace la clé de configuration `XboxPartner:BaseUrl`. |
| `--output <format>` | toutes | Non | `json` (par défaut), `json-compact` ou `table`. `create`, `update`, `publish` et `delete` refusent `table`. |

## Exemples

Répertorier les tests de jeu, en obtenir un et en comparer deux :

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

Créer un test de jeu pour un public :

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

Modifier la date de fin d'un test de jeu :

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

Publier un test de jeu :

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

Supprimer un test de jeu :

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

## Lire les tests de jeu

`playtest list` écrit un tableau `playtests`. Son tableau de sortie comporte les colonnes `PLAYTEST ID`, `NAME`, `STATUS`, `TYPE`,
`START` et `END`. Un extrait :

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

`playtest get` écrit le test de jeu tel que le service le retourne. `etag` est la version à transmettre à
`update --if-match`, et `audiences.audienceIds` répertorie les publics qui peuvent participer. Son tableau de sortie comporte
des lignes `FIELD` et `VALUE`.

`playtest diff` écrit `hasDiffData`, `current` et `compared`. Lorsque `hasDiffData` est `false`,
il n'y a rien à comparer, et `compared` est omis. Son tableau de sortie affiche seulement les champs qui
diffèrent, dans les colonnes `FIELD`, `CURRENT` et `COMPARED`. Les images ne sont pas comparées.

## Créer un test de jeu

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

`playtest create` crée un test de jeu privé à l'état de brouillon et l'écrit comme le fait `playtest get`. L'exécuter
de nouveau crée un autre test de jeu; supprimez celui dont vous ne voulez pas avec
[`playtest delete`](#deleting-a-playtest).

Chaque création envoie une clé d'idempotence, un nouveau GUID à moins que vous ne transmettiez `--idempotency-key`. Une création qui
répète une clé retourne le test de jeu que cette clé a créé, et ignore toutes les options qui diffèrent.

Lorsque le résultat est inconnu, par exemple après un délai d'expiration, la commande se termine avec le code `3` et affiche une commande
qui fait une nouvelle tentative avec la même clé :

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

La nouvelle tentative retourne le test de jeu si la première requête l'a créé, et le crée dans le cas contraire. Lorsqu'une
option contient un saut de ligne, seule la clé est affichée; exécutez la même commande avec
`--idempotency-key` et cette clé. Si la nouvelle tentative est refusée, par exemple parce que la date de fin est passée,
vérifiez `playtest list` avant de créer le test de jeu avec une nouvelle clé.

## Packages

Un test de jeu peut avoir un package PC et un package pour console. Choisissez un package prêt pour un
test de jeu dans [`xbox package list`](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/package#listing-packages), et transmettez son `id` à l'option
de sa plateforme :

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

Avec `update`, une option de package que vous omettez conserve son package, un nouvel ID le remplace, et `""`
le retire :

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

## Mettre à jour un test de jeu

> [!WARNING]
>
> Toute mise à jour remet un test de jeu publié à l'état de brouillon, comme le fait sa modification dans Partner Center. Publiez-le
> de nouveau avec `playtest publish` pour le rendre accessible aux joueurs.

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

`playtest update` modifie seulement les options que vous transmettez, et en nécessite au moins une. Elle écrit le test de jeu
mis à jour comme le fait `playtest get`. Les illustrations du jeu configurées dans Partner Center sont conservées; les autres illustrations liées
au test de jeu sont remplacées par un espace réservé.

Pour éviter d'écraser la modification d'une autre personne, transmettez dans `--if-match` le `etag` provenant de `playtest get`.
Les guillemets doubles qui l'entourent sont facultatifs, et `*`, les etags faibles (`W/`) et les listes d'etags sont
refusés :

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

Lorsque le résultat est inconnu, la commande se termine avec le code `3`. Vérifiez le test de jeu avec `playtest get` avant
de faire une nouvelle tentative.

## Choisir les publics

Un public est un groupe de joueurs, comme des testeurs, que le vendeur gère dans Partner Center.
Transmettez un `id` provenant de [`audience list`](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/audience) à `--audience-id`, et répétez l'option pour en ajouter d'autres :

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

Sans `--audience-id`, `create` crée un test de jeu sans public, et `update` conserve les publics existants. Avec
`update`, les ID que vous transmettez remplacent tous les publics du test de jeu. Pour retirer tous les publics, transmettez
`""` seul :

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

`""` ne peut pas être combiné avec des ID de public, et `create` le refuse. Un test de jeu doit avoir au moins un
public pour être publié.

## Publier un test de jeu

Si le jeu utilise les XBOX services, configurez leur configuration et leur embargo avant de publier. Consultez
[Utiliser les XBOX services dans un test de jeu](https://docs.xbox.com/fr-CA/tools/xbox-cli/xbox-services-in-a-playtest.md).

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

La publication offre le test de jeu à ses publics à partir de sa date de début. La commande publie la
version qu'elle lit en premier; si le test de jeu change entre-temps, la publication échoue avec `412` et
ne modifie rien.

Avant de vous demander de confirmer, la commande vérifie la configuration des XBOX services du jeu, par exemple si
sa date d'embargo est postérieure à la date de fin du test de jeu, et répertorie dans stderr tout élément à examiner. Ces
vérifications sont seulement indicatives; `--confirm` publie sans demander de confirmation.

Le service exécute ensuite ses propres vérifications. Lorsque l'une d'elles bloque la publication, rien n'est mis en file d'attente, et la
commande répertorie chaque vérification dans stderr et se termine avec le code `1`. Corrigez les erreurs et publiez de nouveau. Pour un test de jeu
bloqué en raison de classifications par âge manquantes, il faut remplir le questionnaire de classification par âge dans Partner Center.

Une fois la publication mise en file d'attente, la commande attend que le test de jeu soit `Scheduled`, `Live` ou
`PublishFailed`, et l'écrit comme le fait `playtest get`. Ctrl+C arrête l'attente, mais la publication
se poursuit. Avec `--no-wait`, la commande écrit `publishJobId` et tout `warnings` dès que la
publication est mise en file d'attente; suivez-la ensuite avec `playtest get`.

| Code de sortie | Signification |
| - | - |
| `0` | Le test de jeu est `Scheduled` ou `Live`. Avec `--no-wait`, la publication a été mise en file d'attente. |
| `1` | Non publié, par exemple parce qu'une vérification l'a bloqué ou que le test de jeu a changé. |
| `2` | La publication a échoué : le test de jeu est `PublishFailed`. |
| `3` | La requête a été envoyée, mais son résultat est inconnu. Vérifiez le test de jeu avec `playtest get` avant de publier de nouveau. |
| `4` | La publication a été mise en file d'attente, mais l'attente a pris fin avant qu'elle soit terminée. Vérifiez-la avec `playtest get`. |

## Supprimer un test de jeu

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

`playtest delete` supprime la version du test de jeu qu'elle lit en premier. Elle attend que le test de jeu
soit `Deleted` ou n'existe plus, puis écrit la réponse du service, avec `status`. Ctrl+C arrête l'attente, mais
la suppression se poursuit. Avec `--no-wait`, elle écrit la réponse dès que la suppression est mise en file d'attente.
Après une erreur `412`, la suppression est peut-être déjà en file d'attente; attendez donc une minute et vérifiez avec `playtest get`
avant de supprimer de nouveau.

| Code de sortie | Signification |
| - | - |
| `0` | Supprimé. Avec `--no-wait`, la suppression a été mise en file d'attente. |
| `1` | Non supprimé, par exemple parce que le test de jeu a changé ou que son état ne le permet pas. |
| `3` | La requête a été envoyée, mais son résultat est inconnu. Vérifiez le test de jeu avec `playtest get` avant de supprimer de nouveau. |
| `4` | La suppression a été mise en file d'attente, mais le test de jeu n'était pas `Deleted` avant la fin de l'attente. Vérifiez-le avec `playtest get`. |

## Dates

`--start` et `--end` acceptent des dates et heures ISO 8601, comme `2026-11-01T09:00:00-07:00` ou
`2026-11-01T16:00:00Z`. Une date sans heure correspond à minuit UTC, et une heure sans décalage est
en UTC. Lorsqu'une mise à jour ne transmet qu'une seule date, le service la vérifie par rapport à l'autre date du test de jeu.

## Erreurs

Les échecs sont écrits dans stderr et se terminent avec le code `1`, sauf indication contraire dans les tableaux de codes de sortie ci-dessus. `create` et
`update` se terminent avec le code `3` lorsque leur résultat est inconnu. Un échec retourné par le service inclut son état
HTTP, et `--verbose` ajoute la réponse du service, dont le champ `code` est indiqué ici :

| État | `code` | Signification |
| - | - | - |
| 400 | `invalid_playtest_request` | `create` ou `update` a envoyé une requête non valide, par exemple une fin qui n'est pas postérieure au début. |
| 400 | `playtest_audience_not_found` | Un `--audience-id` ne fait pas partie des publics du vendeur. Le message indique la commande `audience list` à utiliser pour vérifier. |
| 400 | `playtest_package_not_found` | Le jeu n'a aucun package avec cet ID. |
| 400 | `playtest_package_ambiguous` | L'ID de package correspond à plus d'un ensemble de packages et aucun d'eux ne se trouve sur la branche Main du jeu, ou à plus d'un groupe de marchés et aucun d'eux n'est `default`. |
| 400 | `playtest_package_platform_mismatch` | Un package ne correspond pas à la plateforme de son option, par exemple un package pour console dans `--pc-package-id`. Vérifiez sa plateforme avec `xbox package list`. |
| 400 | `playtest_request_rejected` | Partner Center a rejeté la requête, par exemple un `create` ou un `update` avec une date de fin passée ou un package qui n'est pas encore disponible pour les tests de jeu, ou un `publish` d'un test de jeu supprimé. |
| 403 | `audience_permission_denied` | Vous avez transmis `--audience-id` sans l'autorisation de lecture des groupes de clients de Partner Center pour le vendeur. Rien n'a été modifié. Demandez l'accès à un gestionnaire du compte Partner Center. |
| 403 | `package_permission_denied` | Avec `list`, `get` et `diff`, vous n'avez pas l'autorisation de lecture des packages pour le jeu, qu'inclut le rôle Développeur. Avec les autres commandes, vous n'avez pas l'autorisation de modifier les tests de jeu du jeu. Demandez l'accès à un gestionnaire du compte Partner Center. |
| 403 | `playtest_not_enabled` | Les tests de jeu ne sont pas activés pour le jeu et le vendeur, ou le service n'a pas pu le vérifier pour le moment. S'ils devraient être activés, réessayez plus tard. |
| 404 | `playtest_not_found` | Le jeu n'a aucun test de jeu avec cet ID ou cet ID `--compare-to`. Le message indique la commande `playtest list` à utiliser pour vérifier. |
| 404 | `game_not_found` | Le vendeur n'a aucun jeu avec ce Store ID. Vérifiez `--store-id` et `--seller-id`. |
| 409 | `playtest_not_editable` | L'état du test de jeu ne permet pas `update` pour le moment, par exemple pendant sa publication. Vérifiez-le avec `playtest get`. |
| 409 | `playtest_ended` | Le test de jeu est terminé, et `update` n'a pas transmis `--end`. Transmettez une valeur `--end` future avec la modification. |
| 409 | `playtest_not_publishable` | L'état du test de jeu ne permet pas `publish`, ou il a changé depuis sa lecture. Vérifiez-le avec `playtest get`. |
| 409 | `playtest_not_deletable` | L'état du test de jeu ne permet pas `delete`. Vérifiez-le avec `playtest get`. |
| 412 | `playtest_precondition_failed` | Le test de jeu a changé depuis sa lecture. Pour `update`, exécutez `playtest get`, vérifiez que votre modification s'applique toujours, et réessayez avec le nouvel `etag`. Pour `publish` et `delete`, vérifiez le test de jeu et réessayez. |
| 422 | `playtest_publish_blocked` | Les vérifications de publication du service ont échoué; rien n'a donc été mis en file d'attente. La commande répertorie chaque vérification. |

Pour les autres échecs, la commande affiche le message du service. Une erreur 429 signifie que vous avez envoyé trop de
requêtes; attendez la durée indiquée dans le message avant de réessayer.


## Related topics

- [Utiliser Playtest](https://docs.xbox.com/fr-CA/publishing/game-publishing/concepts/playtest-preview.md)
- [Vue d'ensemble de Playtest](https://docs.xbox.com/fr-CA/publishing/game-publishing/concepts/playtest.md)
- [Options de test préalable à la sortie](https://docs.xbox.com/fr-CA/publishing/game-publishing/publishing-processes/managed-creators/publishing-processes-prerelease.md)
- [Modifications de produit et mises à jour de contenu](https://docs.xbox.com/fr-CA/publishing/game-publishing/publishing-processes/managed-creators/publishing-processes-post-release-lifecycle.md)
- [Bacs à sable](https://docs.xbox.com/fr-CA/publishing/game-publishing/concepts/sandboxes.md)
