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
--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 :
testers.txt :
Fichiers de membres
Un fichier de membres est un fichier texte UTF-8 contenant une adresse courriel par ligne, jusqu’à 1000 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 la commande
de nouveau :
- Après
create, exécutez la commandexbox audience list --namequ’affiche stderr. Une correspondance n’est qu’un indice, car les noms n’ont pas à être uniques, et exécutercreatede nouveau peut créer un deuxième public. - 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, 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.
