audience enumeran y obtienen las
audiencias de un vendedor, crean audiencias de usuarios conocidos, y cambian el nombre de una o reemplazan sus miembros. Para permitir que una
audiencia se una a un playtest, pasa su id a playtest create o playtest update; consulta
Elección de audiencias.
audience es experimental: sus comandos, opciones y salida pueden cambiar o quitarse. Consulta
Comandos experimentales. Enumerar y obtener audiencias requiere el permiso
de lectura de grupos de clientes de Partner Center para el vendedor, y crearlas y actualizarlas requiere el permiso
de escritura.
Comandos
La CLI no puede eliminar una audiencia ni cambiar su tipo; hazlo en Partner Center.
Argumentos y opciones
Salida
audience get escribe una audiencia:
audience list escribe una matriz audiences de los mismos objetos, sin members, y
{"audiences":[]} cuando no hay ninguna. create y update escriben la audiencia igual que get.
Con --output table, todos los comandos muestran las columnas ID, NAME y TYPE, donde TYPE es
groupType. Los miembros solo aparecen en la salida JSON.
Creación de una audiencia
--members-file, la audiencia no tiene miembros. Cada ejecución crea una audiencia nueva, aunque
ya exista una con el mismo nombre.
Actualización de una audiencia
Pasa--name, --members-file o ambas; lo que omitas se conserva. Esto cambia el nombre de una audiencia:
testers.txt:
Archivos de miembros
Un archivo de miembros es texto UTF-8 con una dirección de correo electrónico por línea, hasta 1000 miembros:Códigos de salida
create y update envían su solicitud una sola vez. Después de la salida 3, comprueba antes de volver a ejecutar
el comando:
- Después de
create, ejecuta el comandoxbox audience list --nameque muestra stderr. Una coincidencia es solo un indicio, porque los nombres no tienen que ser únicos, y volver a ejecutarcreatepuede crear una segunda audiencia. - Después de
update, ejecutaxbox audience get <audience-id>para comprobar su nombre y sus miembros.
Errores
Los errores van a stderr como texto, sea cual sea--output, con el identificador de correlación, indicaciones para el
estado HTTP y el detalle del error del servicio, cuando lo hay. --verbose agrega la respuesta del servicio,
que puede incluir miembros. Los scripts deben bifurcarse según el código de salida, no según el texto.
Un 403 puede indicar que falta un permiso, que no perteneces al vendedor o que los playtests
no están habilitados para él. En list y get, un rechazo puede aparecer en su lugar como un 502; consulta el detalle
del error para conocer la causa. La creación y actualización de audiencias se está implementando gradualmente y es posible que aún no esté disponible
para ti; hasta que lo esté, create y update fallan sin cambiar nada.
