Pular para o conteúdo principal
Um público é um grupo nomeado de jogadores ou dispositivos, como testadores, para o qual um vendedor pode direcionar conteúdo. O Partner Center chama esses públicos de grupos de clientes. Os comandos audience listam e obtêm os públicos de um vendedor, criam públicos de usuários conhecidos e renomeiam um público ou substituem seus membros. Para permitir que um público participe de um playtest, passe a id dele para playtest create ou playtest update; consulte Escolher públicos. audience é Experimental: seus comandos, opções e saída podem mudar ou ser removidos. Consulte Comandos experimentais. Listar e obter públicos exige a permissão Read de grupos de clientes do Partner Center para o vendedor, e criá-los e atualizá-los exige a permissão Write.

Comandos

A CLI não pode excluir um público nem alterar o tipo dele; faça isso no Partner Center.

Argumentos e opções

Saída

audience get grava um público:
audience list grava uma matriz audiences com os mesmos objetos, sem members, e {"audiences":[]} quando não há nenhum. create e update gravam o público da mesma forma que get. Com --output table, todos os comandos mostram as colunas ID, NAME e TYPE, em que TYPE é groupType. Os membros aparecem somente na saída JSON.

Criar um público

Sem --members-file, o público não tem membros. Cada execução cria um novo público, mesmo quando já existe um com o mesmo nome.

Atualizar um público

Passe --name, --members-file ou ambos; o que você omitir será mantido. Este comando renomeia um público:
Este substitui os membros dele pelos endereços em testers.txt:
--members-file substitui a lista completa de membros. Os membros que não estiverem no arquivo serão removidos, e um arquivo vazio remove todos os membros. Para adicionar ou remover um membro, leia a lista com audience get, altere-a e passe a lista inteira.
A atualização não é verificada em relação a outras alterações: se duas pessoas atualizarem um público ao mesmo tempo, a última prevalece.

Arquivos de membros

Um arquivo de membros é um texto UTF-8 com um endereço de email por linha, com até 1.000 membros:
Linhas em branco e espaços ao redor de cada linha são ignorados. O serviço verifica cada membro, mas um membro armazenado não comprova que ele corresponde a uma conta que pode ver o conteúdo direcionado ao público.

Códigos de saída

create e update enviam sua solicitação uma única vez. Depois do código de saída 3, verifique antes de executar o comando novamente:
  • Depois de create, execute o comando xbox audience list --name que stderr mostra. Uma correspondência é apenas uma indicação, porque os nomes não precisam ser exclusivos, e executar create novamente pode criar um segundo público.
  • Depois de update, execute xbox audience get <audience-id> para verificar o nome e os membros dele.

Erros

Os erros vão para stderr como texto, qualquer que seja o valor de --output, com a ID de correlação, orientações para o status HTTP e o detalhe do erro do serviço, quando houver. --verbose adiciona a resposta do serviço, que pode incluir membros. Os scripts devem se basear no código de saída, e não no texto da mensagem. Um 403 pode significar uma permissão ausente, que você não pertence ao vendedor ou que os playtests não estão habilitados para ele. Em list e get, uma recusa pode aparecer como 502; verifique o detalhe do erro para saber a causa. A criação e a atualização de públicos estão sendo distribuídas e talvez ainda não estejam disponíveis para você; até que estejam, create e update falham sem alterar nada.

Exemplos

Listar e obter públicos:
Criar um público sem a solicitação de confirmação:
Substituir os membros de um público e mostrar o resultado como uma tabela:
Última modificação em 19 de novembro de 2026