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

# Audience

> Répertoriez, obtenez, créez et mettez à jour les audiences d'un vendeur Partner Center.

Une audience est un groupe nommé de joueurs ou d'appareils, comme des testeurs, auquel un vendeur peut destiner
du contenu. Partner Center les appelle des groupes de clients. Les commandes `audience` répertorient et obtiennent les
audiences d'un vendeur, créent des audiences d'utilisateurs connus, et renomment une audience ou remplacent ses membres. Pour permettre à une
audience de participer à un test de jeu, passez son `id` à `playtest create` ou `playtest update` ; consultez
[Choix des audiences](https://docs.xbox.com/fr/tools/xbox-cli/commands/playtest.md#choosing-audiences).

`audience` est expérimentale : ses commandes, ses options et sa sortie peuvent changer ou être supprimées. Consultez
[Commandes expérimentales](https://docs.xbox.com/fr/tools/xbox-cli/cli-command-lifecycle.md). Pour répertorier et obtenir des audiences, vous avez besoin de l'autorisation
de lecture (Read) sur les groupes de clients de Partner Center pour le vendeur, et pour les créer et les mettre à jour, de l'autorisation
d'écriture (Write).

## Commandes

| Commande | Description |
| - | - |
| `audience list` | Répertorie les audiences du vendeur. |
| `audience get <audience-id>` | Obtient une audience, avec ses membres. |
| `audience create` | Crée une audience d'utilisateurs connus. |
| `audience update <audience-id>` | Renomme une audience d'utilisateurs connus ou remplace sa liste complète de membres. |

La CLI ne peut pas supprimer une audience ni changer son type ; faites-le dans Partner Center.

## Arguments et options

| Argument ou option | S'applique à | Obligatoire | Description |
| - | - | - | - |
| `<audience-id>` | `get`, `update` | Oui | ID de l'audience, exactement tel que `list` le renvoie, comme `1152921504606846976`. |
| `--name <text>` | `list` | Non | Répertorie uniquement les audiences dont le nom contient ce texte, sans tenir compte de la casse. |
| `--name <text>` | `create`, `update` | `create` | Nom de l'audience, jusqu'à 200 caractères. Il ne peut pas être vide et n'a pas besoin d'être unique. |
| `--members-file <path>` | `create`, `update` | Non | Fichier répertoriant les membres. Consultez [Fichiers de membres](#members-files). |
| `--confirm` (`--yes`, `-y`) | `create`, `update` | Non | Ignore l'invite de confirmation. Sans cette option, la commande demande confirmation dans un terminal et échoue dans les autres cas. |
| `--seller-id <id>` | toutes | Si non enregistré | ID de vendeur Partner Center. Consultez [Contexte](https://docs.xbox.com/fr/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`. |

## Sortie

`audience get` écrit une audience :

```json theme={null}
{
  "name": "Nod Arena testers",
  "id": "1152921504606846976",
  "members": ["dev@nodpublishers.com"],
  "dnaTags": ["AppFlighting"],
  "sellerId": "1234567",
  "groupType": "User",
  "groupUsage": "ForPackageFlight, ForLimitedDistribution"
}
```

| Champ | Description |
| - | - |
| `name` | Le nom de l'audience, ou `null`. |
| `id` | L'ID de l'audience. Passez-le tel quel aux autres commandes. |
| `members` | Les membres enregistrés. `list` omet ce champ. |
| `dnaTags` | Les balises de l'audience. |
| `sellerId` | Le vendeur propriétaire de l'audience. |
| `groupType` | Le type d'audience, comme `User`, `PreCreated` ou `XboxDevice`, ou `null`. Seules les audiences `User` peuvent être mises à jour. |
| `groupUsage` | L'usage de l'audience, sous forme d'indicateurs séparés par des virgules, ou `null`. |

`audience list` écrit un tableau `audiences` contenant les mêmes objets, sans `members`, et
`{"audiences":[]}` lorsqu'il n'y en a aucune. `create` et `update` écrivent l'audience comme le fait `get`.

Avec `--output table`, chaque commande affiche les colonnes `ID`, `NAME` et `TYPE`, où `TYPE` correspond à
`groupType`. Les membres n'apparaissent que dans la sortie JSON.

## Création d'une audience

```bash theme={null}
xbox audience create --name "Nod Arena testers" --members-file testers.txt
```

Sans `--members-file`, l'audience n'a aucun membre. Chaque exécution crée une nouvelle audience, même lorsqu'il
en existe déjà une portant le même nom.

## Mise à jour d'une audience

Passez `--name`, `--members-file` ou les deux ; ce que vous omettez est conservé. Cette commande renomme une audience :

```bash theme={null}
xbox audience update 1152921504606846976 --name "Nod Arena beta testers"
```

Celle-ci remplace ses membres par les adresses figurant dans `testers.txt` :

```bash theme={null}
xbox audience update 1152921504606846976 --members-file testers.txt
```

> [!WARNING]
>
> `--members-file` remplace la liste complète des membres. Les membres absents du fichier sont supprimés, et un
> fichier vide supprime tous les membres. Pour ajouter ou supprimer un seul membre, lisez la liste avec `audience get`,
> modifiez-la, puis passez la liste entière.

La mise à jour n'est pas vérifiée par rapport à d'autres modifications : si deux personnes mettent à jour une audience en même temps,
la dernière l'emporte.

## Fichiers de membres

Un fichier de membres est un fichier texte UTF-8 contenant une adresse e-mail par ligne, jusqu'à 1 000 membres :

```text theme={null}
dev@nodpublishers.com
tester@nodpublishers.com
```

Les lignes vides et les espaces autour de chaque ligne sont ignorés. Le service vérifie chaque membre, mais un membre
enregistré ne garantit pas qu'il correspond à un compte capable de voir le contenu destiné à l'audience.

## Codes de sortie

| Code de sortie | Signification |
| - | - |
| `0` | La commande a réussi. |
| `1` | La commande a échoué, et rien n'a été modifié. |
| `3` | `create` ou `update` a envoyé sa requête, mais son résultat est inconnu. L'ID de corrélation figure sur stderr. |

`create` et `update` envoient leur requête une seule fois. Après le code de sortie `3`, vérifiez avant d'exécuter de nouveau
la commande :

* Après `create`, exécutez la commande `xbox audience list --name` qu'affiche stderr. Une correspondance n'est qu'une
  indication, car les noms n'ont pas besoin d'être uniques, et exécuter de nouveau `create` peut créer une deuxième
  audience.
* Après `update`, exécutez `xbox audience get <audience-id>` pour vérifier son nom et ses membres.

## Erreurs

Les erreurs sont écrites sur stderr sous forme de texte, quel que soit `--output`, avec l'ID de corrélation, des conseils sur le
statut HTTP et le détail de l'erreur du service, le cas échéant. `--verbose` ajoute la réponse du
service, qui peut inclure des membres. Les scripts doivent se baser sur le code de sortie, et non sur le libellé.

Une erreur 403 peut signifier qu'une autorisation manque, que vous n'appartenez pas au vendeur ou que les tests de jeu
ne sont pas activés pour celui-ci. Avec `list` et `get`, un refus peut plutôt apparaître sous la forme d'une erreur 502 ; consultez le
détail de l'erreur pour en connaître la cause. La création et la mise à jour d'audiences sont en cours de déploiement et ne sont peut-être pas encore
disponibles pour vous ; d'ici là, `create` et `update` échouent sans rien modifier.

## Exemples

Répertorier et obtenir des audiences :

```bash theme={null}
xbox audience list --name testers
xbox audience list --output table
xbox audience get 1152921504606846976 --seller-id 1234567
```

Créer une audience sans l'invite de confirmation :

```bash theme={null}
xbox audience create --name "Nod Arena testers" --members-file testers.txt --confirm
```

Remplacer les membres d'une audience et afficher le résultat sous forme de tableau :

```bash theme={null}
xbox audience update 1152921504606846976 --members-file testers.txt --output table
```


## Related topics

- [Visibilité - Audiences](https://docs.xbox.com/fr/publishing/game-publishing/concepts/availability/visibility-audiences.md)
- [Visibilité](https://docs.xbox.com/fr/publishing/game-publishing/concepts/availability/visibility.md)
- [Configurer la tarification et la disponibilité d'un jeu](https://docs.xbox.com/fr/publishing/game-publishing/tutorial-xbox-managed/how-to-configure-pricing-and-availability.md)
- [Revendications des jetons de sécurité des services XBOX](https://docs.xbox.com/fr/services/xbox-services/fundamentals/s2s-auth-calls/service-authentication/security-tokens/live-token-claims.md)
- [Playtest](https://docs.xbox.com/fr/tools/xbox-cli/commands/playtest.md)
