Audiências
Listas com nome em que os contactos são agrupados.
Ferramentas de audiências
| Ferramenta | O que faz |
|---|---|
| listAudiences | As listas em que esta caixa de correio agrupa os seus contactos, a predefinida primeiro. Uma audiência é um agrupamento e mais nada. |
| getAudience | Uma audiência por inteiro: o nome, para que serve, quantos contactos tem e se é a predefinida. |
| createAudience | Cria uma lista com nome. É criada vazia, e nada impede duas audiências de partilharem um nome, por isso leia a lista primeiro. |
| updateAudience | Muda o nome de uma audiência ou altera aquilo que diz servir. A audiência predefinida pode ser renomeada como qualquer outra e continua a ser a predefinida, seja qual for o nome. |
| deleteAudience | Apaga uma audiência. A pertença desaparece, todos os contactos que estavam nela permanecem. A audiência predefinida não pode ser apagada. |
| listAudienceContacts | Quem está numa audiência. Pedir a audiência predefinida lista todos os contactos da caixa de correio. |
| addContactToAudience | Coloca um contacto existente numa audiência. Nunca cria um contacto, porque um endereço mal escrito tornar-se-ia uma linha permanente que ninguém pediu. |
| removeContactFromAudience | Retira um contacto de uma audiência. Continua a ser um contacto, com as suas notas e as suas outras audiências. |
Todas as caixas de correio têm uma audiência predefinida que contém todos os contactos, e é a única coisa aqui que não pode ser apagada nem reduzida. Tirar alguém dela significaria um contacto que o listContacts mostra e o listAudienceContacts não consegue mostrar, o que é um livro de endereços em contradição consigo próprio. O deleteContact é o que remove alguém por completo da caixa de correio.
Nada aqui envia para uma audiência, e não existe nenhuma ferramenta que o faça. Uma audiência é uma forma de agrupar contactos, não uma lista de subscrição, e pôr alguém numa não lhe envia correio nenhum.
Adicionar um contacto a uma lista é uma escrita na LISTA e não no contacto, pelo que está protegido por audiences:write e não por contacts:write. Ler os endereços de uma audiência precisa apenas de audiences:read.