Grupy odbiorców
Nazwane listy, w które grupowane są kontakty.
Narzędzia grup odbiorców
| Narzędzie | Co robi |
|---|---|
| listAudiences | Listy, w które ta skrzynka grupuje swoje kontakty, domyślna na początku. Grupa odbiorców to sposób grupowania i nic poza tym. |
| getAudience | Jedna grupa odbiorców w całości: jej nazwa, przeznaczenie, liczba kontaktów w niej i to, czy jest domyślna. |
| createAudience | Utwórz nazwaną listę. Powstaje pusta i nic nie stoi na przeszkodzie, by dwie grupy odbiorców miały tę samą nazwę, więc najpierw przeczytaj listę. |
| updateAudience | Zmień nazwę grupy odbiorców albo to, do czego według opisu służy. Domyślną grupę można przemianować jak każdą inną i pozostaje domyślna niezależnie od nazwy. |
| deleteAudience | Usuń grupę odbiorców. Znika przynależność, każdy kontakt, który w niej był, zostaje. Domyślnej grupy odbiorców nie da się usunąć. |
| listAudienceContacts | Kto jest w danej grupie odbiorców. Zapytanie o domyślną grupę wymienia każdy kontakt w skrzynce. |
| addContactToAudience | Umieść istniejący kontakt w grupie odbiorców. Nigdy nie tworzy kontaktu, bo błędnie wpisany adres stałby się trwałym wierszem, o który nikt nie prosił. |
| removeContactFromAudience | Wyjmij kontakt z grupy odbiorców. Pozostaje kontaktem, ze swoimi notatkami i pozostałymi grupami odbiorców. |
Każda skrzynka ma domyślną grupę odbiorców zawierającą wszystkie kontakty i jest to jedyna rzecz tutaj, której nie da się usunąć ani przerzedzić. Wyjęcie z niej kogoś oznaczałoby kontakt, który listContacts pokazuje, a listAudienceContacts nie — czyli książkę adresową sprzeczną ze sobą. To deleteContact usuwa kogoś ze skrzynki całkowicie.
Nic tutaj nie wysyła do grupy odbiorców i nie ma narzędzia, które by to robiło. Grupa odbiorców to sposób grupowania kontaktów, a nie lista subskrypcyjna, i umieszczenie w niej kogoś nie wysyła mu niczego.
Dodanie kontaktu do listy jest zapisem do LISTY, a nie do kontaktu, więc bramkuje je audiences:write, a nie contacts:write. Odczyt adresów w grupie odbiorców wymaga tylko audiences:read.