Saltar al contenido principal
Una audiencia es un grupo con nombre de jugadores o dispositivos, como evaluadores, al que un vendedor puede dirigir contenido. Partner Center los llama grupos de clientes. Los comandos 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

Sin --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:
Esto reemplaza sus miembros por las direcciones de testers.txt:
--members-file reemplaza la lista completa de miembros. Los miembros que no están en el archivo se quitan, y un archivo vacío quita a todos los miembros. Para agregar o quitar un miembro, lee la lista con audience get, cámbiala y pasa la lista completa.
La actualización no se comprueba frente a otros cambios: si dos personas actualizan una audiencia a la vez, prevalece la última.

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:
Se omiten las líneas en blanco y los espacios alrededor de cada línea. El servicio comprueba cada miembro, pero un miembro almacenado no demuestra que corresponda a una cuenta que pueda ver el contenido dirigido a la audiencia.

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 comando xbox audience list --name que muestra stderr. Una coincidencia es solo un indicio, porque los nombres no tienen que ser únicos, y volver a ejecutar create puede crear una segunda audiencia.
  • Después de update, ejecuta xbox 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.

Ejemplos

Enumerar y obtener audiencias:
Crear una audiencia sin la solicitud de confirmación:
Reemplazar los miembros de una audiencia y mostrar el resultado como una tabla:
Última modificación el 19 de noviembre de 2026