Audiences
Benannte Listen, in die die Kontakte gruppiert sind.
Audiences-Tools
| Tool | Was es tut |
|---|---|
| listAudiences | Die Listen, in die dieses Postfach seine Kontakte gruppiert, die Standardliste zuerst. Eine Audience ist eine Gruppierung und sonst nichts. |
| getAudience | Eine Audience vollständig: ihr Name, wofür sie da ist, wie viele Kontakte in ihr sind und ob sie die Standardaudience ist. |
| createAudience | Eine benannte Liste anlegen. Sie wird leer erstellt, und nichts hindert zwei Audiences daran, denselben Namen zu tragen – lesen Sie also zuerst die Liste. |
| updateAudience | Eine Audience umbenennen oder ändern, wofür sie laut Beschreibung da ist. Die Standardaudience lässt sich wie jede andere umbenennen und bleibt die Standardaudience, wie sie auch heißt. |
| deleteAudience | Eine Audience löschen. Die Mitgliedschaft verschwindet, jeder Kontakt, der darin war, bleibt. Die Standardaudience kann nicht gelöscht werden. |
| listAudienceContacts | Wer in einer Audience ist. Eine Abfrage der Standardaudience listet jeden Kontakt des Postfachs. |
| addContactToAudience | Einen bestehenden Kontakt in eine Audience aufnehmen. Es legt nie einen Kontakt an, denn eine vertippte Adresse würde zu einer dauerhaften Zeile, um die niemand gebeten hat. |
| removeContactFromAudience | Einen Kontakt aus einer Audience nehmen. Er bleibt ein Kontakt, mit seinen Notizen und seinen übrigen Audiences. |
Jedes Postfach hat eine Standardaudience, die jeden Kontakt enthält, und sie ist das Einzige hier, das sich nicht löschen oder ausdünnen lässt. Jemanden daraus zu entfernen hieße, einen Kontakt zu haben, den listContacts zeigt und listAudienceContacts nicht zeigen kann – ein Adressbuch, das sich selbst widerspricht. deleteContact ist das, was jemanden vollständig aus dem Postfach entfernt.
Nichts hier sendet an eine Audience, und es gibt auch kein Tool, das das tut. Eine Audience ist eine Art, Kontakte zu gruppieren, keine Abonnementliste, und jemanden hineinzustellen mailt ihm nichts.
Einen Kontakt zu einer Liste hinzuzufügen ist ein Schreibvorgang auf der LISTE und nicht auf dem Kontakt; es hängt deshalb an audiences:write und nicht an contacts:write. Die Adressen in einer Audience zu lesen braucht nur audiences:read.