Passer au contenu principal
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. audience est expérimentale : ses commandes, ses options et sa sortie peuvent changer ou être supprimées. Consultez Commandes expérimentales. 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

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

Arguments et options

Sortie

audience get écrit une audience :
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

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 :
Celle-ci remplace ses membres par les adresses figurant dans testers.txt :
--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 :
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

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 :
Créer une audience sans l’invite de confirmation :
Remplacer les membres d’une audience et afficher le résultat sous forme de tableau :
Dernière modification le 19 novembre 2026