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

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

Arguments et options

Sortie

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

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

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