Audiences
Benoemde lijsten waarin de contacten worden gegroepeerd.
Tools voor audiences
| Tool | Wat het doet |
|---|---|
| listAudiences | De lijsten waarin deze mailbox zijn contacten groepeert, de standaardlijst eerst. Een audience is een groepering en niets anders. |
| getAudience | Eén audience in zijn geheel: de naam, waar hij voor is, hoeveel contacten erin zitten en of het de standaard is. |
| createAudience | Maak een benoemde lijst. Hij wordt leeg aangemaakt, en niets belet twee audiences dezelfde naam te delen, dus lees eerst de lijst. |
| updateAudience | Hernoem een audience of wijzig waar hij volgens zijn omschrijving voor is. De standaard-audience kan net als elke andere worden hernoemd en blijft de standaard, hoe hij ook heet. |
| deleteAudience | Verwijder een audience. Het lidmaatschap verdwijnt, elk contact dat erin zat blijft. De standaard-audience kan niet worden verwijderd. |
| listAudienceContacts | Wie er in één audience zitten. De standaard-audience opvragen toont elk contact op de mailbox. |
| addContactToAudience | Zet een bestaand contact in een audience. Het maakt nooit een contact aan, want een verkeerd getypt adres zou een permanente rij worden waar niemand om vroeg. |
| removeContactFromAudience | Haal een contact uit een audience. Het blijft een contact, met zijn notities en zijn andere audiences. |
Elke mailbox heeft een standaard-audience die elk contact bevat, en dat is het enige hier dat niet kan worden verwijderd of uitgedund. Iemand eruit halen zou betekenen dat er een contact is dat listContacts wel toont en listAudienceContacts niet, en dat is een boek dat zichzelf tegenspreekt. deleteContact is wat iemand volledig uit de mailbox verwijdert.
Niets hier verzendt naar een audience, en er is geen tool die dat doet. Een audience is een manier om contacten te groeperen, geen abonneelijst, en iemand erin zetten mailt hem niets.
Een contact aan een lijst toevoegen is een schrijfactie op de LIJST en niet op het contact, dus het zit achter audiences:write en niet achter contacts:write. De adressen in een audience lezen vereist alleen audiences:read.