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
--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:
testers.txt:
Arquivos de membros
Um arquivo de membros é um texto UTF-8 com um endereço de email por linha, com até 1.000 membros: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 comandoxbox audience list --nameque stderr mostra. Uma correspondência é apenas uma indicação, porque os nomes não precisam ser exclusivos, e executarcreatenovamente pode criar um segundo público. - Depois de
update, executexbox 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.
