Audiencias
Listas con nombre en las que se agrupan los contactos.
Herramientas de audiencias
| Herramienta | Qué hace |
|---|---|
| listAudiences | Las listas en las que este buzón agrupa sus contactos, la predeterminada primero. Una audiencia es una agrupación y nada más. |
| getAudience | Una audiencia completa: su nombre, para qué sirve, cuántos contactos tiene y si es la predeterminada. |
| createAudience | Crea una lista con nombre. Se crea vacía, y nada impide que dos audiencias compartan nombre, así que lee antes la lista. |
| updateAudience | Renombra una audiencia o cambia para qué dice que sirve. La audiencia predeterminada se puede renombrar como cualquier otra y sigue siendo la predeterminada se llame como se llame. |
| deleteAudience | Elimina una audiencia. La pertenencia desaparece, y todos los contactos que estaban en ella se mantienen. La audiencia predeterminada no se puede eliminar. |
| listAudienceContacts | Quién está en una audiencia. Pedir la audiencia predeterminada enumera todos los contactos del buzón. |
| addContactToAudience | Pone un contacto existente en una audiencia. Nunca crea un contacto, porque una dirección mal escrita se convertiría en una fila permanente que nadie pidió. |
| removeContactFromAudience | Saca un contacto de una audiencia. Sigue siendo un contacto, con sus notas y sus demás audiencias. |
Todo buzón tiene una audiencia predeterminada que contiene todos los contactos, y es lo único aquí que no se puede eliminar ni recortar. Sacar a alguien de ella supondría un contacto que listContacts muestra y listAudienceContacts no puede mostrar, es decir, una libreta que se contradice a sí misma. deleteContact es lo que elimina a alguien del buzón por completo.
Nada de esto envía a una audiencia, y no hay ninguna herramienta que lo haga. Una audiencia es una forma de agrupar contactos, no una lista de suscripción, y meter a alguien en una no le envía ningún correo.
Añadir un contacto a una lista es una escritura sobre la LISTA y no sobre el contacto, así que está protegido por audiences:write y no por contacts:write. Leer las direcciones de una audiencia solo necesita audiences:read.