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
--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 :
testers.txt :
Fichiers de membres
Un fichier de membres est un fichier texte UTF-8 contenant une adresse e-mail par ligne, jusqu’à 1 000 membres :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 commandexbox audience list --namequ’affiche stderr. Une correspondance n’est qu’une indication, car les noms n’ont pas besoin d’être uniques, et exécuter de nouveaucreatepeut créer une deuxième audience. - Après
update, exécutezxbox 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.
