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

# Public

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

Un public 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
publics d'un vendeur, créent des publics d'utilisateurs connus, et en renomment un ou en remplacent les membres. Pour permettre à un
public de participer à un test de jeu, transmettez son `id` à `playtest create` ou à `playtest update`; consultez
[Choisir les publics](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/playtest.md#choosing-audiences).

`audience` est expérimentale : ses commandes, ses options et sa sortie peuvent changer ou être retirées. Consultez
[Commandes expérimentales](https://docs.xbox.com/fr-CA/tools/xbox-cli/cli-command-lifecycle.md). Pour répertorier et obtenir des publics, il faut l'autorisation
Lecture des groupes de clients de Partner Center pour le vendeur, et pour les créer et les mettre à jour, il faut
l'autorisation Écriture.

## Commandes

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

La CLI ne peut pas supprimer un public 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 du public, exactement tel que `list` le retourne, comme `1152921504606846976`. |
| `--name <text>` | `list` | Non | Répertorie seulement les publics dont le nom contient ce texte, sans tenir compte de la casse. |
| `--name <text>` | `create`, `update` | `create` | Nom du public, jusqu'à 200 caractères. Il ne peut pas être vide et n'a pas à être unique. |
| `--members-file <path>` | `create`, `update` | Non | Fichier qui répertorie 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 une confirmation dans un terminal et échoue autrement. |
| `--seller-id <id>` | toutes | S'il n'est pas enregistré | 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`. |

## Sortie

`audience get` écrit un public :

```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 du public, ou `null`. |
| `id` | L'ID du public. Transmettez-le tel quel aux autres commandes. |
| `members` | Les membres enregistrés. `list` omet ce champ. |
| `dnaTags` | Les étiquettes du public. |
| `sellerId` | Le vendeur propriétaire du public. |
| `groupType` | Le type de public, comme `User`, `PreCreated` ou `XboxDevice`, ou `null`. Seuls les publics `User` peuvent être mis à jour. |
| `groupUsage` | L'utilisation du public, 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 aucun. `create` et `update` écrivent le public de la même façon que `get`.

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

## Créer un public

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

Sans `--members-file`, le public n'a aucun membre. Chaque exécution crée un nouveau public, même lorsqu'un
public du même nom existe déjà.

## Mettre à jour un public

Transmettez `--name`, `--members-file` ou les deux; ce que vous omettez est conservé. Cette commande renomme un public :

```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 retirés, et un
> fichier vide retire tous les membres. Pour ajouter ou retirer un seul membre, lisez la liste avec `audience get`,
> modifiez-la et transmettez la liste entière.

La mise à jour n'est pas vérifiée par rapport aux autres modifications : si deux personnes mettent à jour un public 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 courriel par ligne, jusqu'à 1000 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 prouve pas qu'il correspond à un compte qui peut voir le contenu destiné au public.

## Codes de sortie

| Code de sortie | Signification |
| - | - |
| `0` | La commande a réussi. |
| `1` | La commande a échoué, et rien n'a changé. |
| `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 la commande
de nouveau :

* Après `create`, exécutez la commande `xbox audience list --name` qu'affiche stderr. Une correspondance n'est qu'un
  indice, car les noms n'ont pas à être uniques, et exécuter `create` de nouveau peut créer un deuxième
  public.
* 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, quelle que soit la valeur de `--output`, avec l'ID de corrélation, des conseils sur le
statut HTTP et le détail de l'erreur du service, s'il y en a un. `--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 une autorisation manquante, 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 forme d'erreur 502; consultez le détail
de l'erreur pour en connaître la cause. La création et la mise à jour de publics sont en cours de déploiement et pourraient ne pas encore être offertes
pour vous; d'ici là, `create` et `update` échouent sans rien modifier.

## Exemples

Répertorier et obtenir des publics :

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

Créer un public sans l'invite de confirmation :

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

Remplacer les membres d'un public 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é - Publics](https://docs.xbox.com/fr-CA/publishing/game-publishing/concepts/availability/visibility-audiences.md)
- [Get Title Public Key](https://docs.xbox.com/api-reference/authentication/get-title-public-key.md)
- [PFMultiplayerServerPublicIpAddress](https://docs.xbox.com/fr-CA/services/playfab/api-references/c/pfmultiplayerservertypes/structs/pfmultiplayerserverpublicipaddress.md)
- [Publication et test dans le bac à sable RETAIL](https://docs.xbox.com/fr-CA/publishing/game-publishing/publishing-processes/managed-creators/publishing-processes-retail-publishing-and-testing.md)
- [Vue d'ensemble de la publication](https://docs.xbox.com/fr-CA/publishing/game-publishing/overview.md)
