Audiències
Llistes amb nom en què s'agrupen els contactes.
Eines d'audiències
| Eina | Què fa |
|---|---|
| listAudiences | Les llistes en què aquesta bústia agrupa els seus contactes, primer la predeterminada. Una audiència és una agrupació i res més. |
| getAudience | Una audiència sencera: el seu nom, per a què serveix, quants contactes té i si és la predeterminada. |
| createAudience | Crea una llista amb nom. Es crea buida, i res no impedeix que dues audiències comparteixin nom, així que llegeix primer la llista. |
| updateAudience | Canvia el nom d'una audiència o allò que diu que fa. L'audiència predeterminada es pot reanomenar com qualsevol altra i continua sent la predeterminada es digui com es digui. |
| deleteAudience | Elimina una audiència. La pertinença desapareix, tots els contactes que hi havia es mantenen. L'audiència predeterminada no es pot eliminar. |
| listAudienceContacts | Qui hi ha en una audiència. Demanar l'audiència predeterminada llista tots els contactes de la bústia. |
| addContactToAudience | Posa un contacte existent en una audiència. Mai no crea un contacte, perquè una adreça mal escrita es convertiria en una fila permanent que ningú no ha demanat. |
| removeContactFromAudience | Treu un contacte d'una audiència. Continua sent un contacte, amb les seves notes i les seves altres audiències. |
Cada bústia té una audiència predeterminada que conté tots els contactes, i és l'única cosa d'aquí que no es pot eliminar ni buidar. Treure'n algú significaria un contacte que listContacts mostra i listAudienceContacts no pot mostrar, que és una llibreta que es contradiu a si mateixa. deleteContact és el que elimina algú de la bústia del tot.
Res d'aquí no envia a una audiència, i no hi ha cap eina que ho faci. Una audiència és una manera d'agrupar contactes, no una llista de subscripció, i posar-hi algú no li envia cap correu.
Afegir un contacte a una llista és una escriptura a la LLISTA i no al contacte, de manera que està protegit per audiences:write i no per contacts:write. Llegir les adreces d'una audiència només necessita audiences:read.