Audiences
Les listes nommées dans lesquelles les contacts sont regroupés.
Outils Audiences
| Outil | Ce qu'il fait |
|---|---|
| listAudiences | Les listes dans lesquelles cette boîte aux lettres regroupe ses contacts, celle par défaut en premier. Une audience est un regroupement et rien d'autre. |
| getAudience | Une audience en détail : son nom, à quoi elle sert, combien de contacts elle contient et si c'est celle par défaut. |
| createAudience | Créer une liste nommée. Elle est créée vide, et rien n'empêche deux audiences de porter le même nom : lisez donc d'abord la liste. |
| updateAudience | Renommer une audience ou modifier ce qu'elle dit servir. L'audience par défaut peut être renommée comme n'importe quelle autre et reste celle par défaut quel que soit son nom. |
| deleteAudience | Supprimer une audience. L'appartenance disparaît, chaque contact qui s'y trouvait reste. L'audience par défaut ne peut pas être supprimée. |
| listAudienceContacts | Qui se trouve dans une audience. Demander l'audience par défaut liste tous les contacts de la boîte aux lettres. |
| addContactToAudience | Placer un contact existant dans une audience. L'outil ne crée jamais de contact, car une adresse mal saisie deviendrait une ligne permanente que personne n'a demandée. |
| removeContactFromAudience | Retirer un contact d'une audience. Il reste un contact, avec ses notes et ses autres audiences. |
Chaque boîte aux lettres a une audience par défaut qui contient tous les contacts, et c'est la seule chose ici qui ne peut être ni supprimée ni allégée. En retirer quelqu'un donnerait un contact que listContacts affiche et que listAudienceContacts ne peut pas afficher, c'est-à-dire un carnet en contradiction avec lui-même. C'est deleteContact qui retire quelqu'un entièrement de la boîte aux lettres.
Rien ici n'envoie à une audience, et aucun outil ne le fait. Une audience est une façon de regrouper des contacts, pas une liste d'abonnement, et y placer quelqu'un ne lui envoie rien.
Ajouter un contact à une liste est une écriture sur la LISTE plutôt que sur le contact : l'opération est donc protégée par audiences:write et non par contacts:write. Lire les adresses d'une audience ne demande que audiences:read.