Audiencat
Lista të emërtuara në të cilat grupohen kontaktet.
Veglat e audiencave
| Vegla | Çfarë bën |
|---|---|
| listAudiences | Listat në të cilat kjo kuti postare grupon kontaktet e veta, e parazgjedhura e para. Një audiencë është grupim dhe asgjë më shumë. |
| getAudience | Një audiencë e plotë: emri i saj, për çfarë shërben, sa kontakte ka brenda dhe nëse është e parazgjedhura. |
| createAudience | Krijoni një listë të emërtuar. Krijohet bosh, dhe asgjë nuk i ndalon dy audienca të ndajnë të njëjtin emër, prandaj lexoni më parë listën. |
| updateAudience | Riemërtoni një audiencë ose ndryshoni se për çfarë thotë që shërben. Audienca e parazgjedhur mund të riemërtohet si çdo tjetër dhe mbetet e parazgjedhura sido që të quhet. |
| deleteAudience | Fshini një audiencë. Anëtarësia shkon, çdo kontakt që ishte brenda mbetet. Audienca e parazgjedhur nuk mund të fshihet. |
| listAudienceContacts | Kush është në një audiencë. Kërkesa për audiencën e parazgjedhur rendit çdo kontakt të kutisë postare. |
| addContactToAudience | Vendosni një kontakt ekzistues në një audiencë. Nuk krijon kurrë kontakt, sepse një adresë e shtypur gabim do të bëhej një rresht i përhershëm që nuk e kërkoi askush. |
| removeContactFromAudience | Nxirreni një kontakt nga një audiencë. Mbetet kontakt, me shënimet e veta dhe audiencat e tjera. |
Çdo kuti postare ka një audiencë të parazgjedhur që mban çdo kontakt, dhe është e vetmja gjë këtu që nuk mund të fshihet a të hollohet. Nxjerrja e dikujt prej saj do të thoshte një kontakt që listContacts e shfaq dhe listAudienceContacts nuk mundet, që është një libër në kundërshtim me vetveten. deleteContact është ajo që e heq dikë tërësisht nga kutia postare.
Asgjë këtu nuk i dërgon një audience, dhe nuk ka vegël që e bën. Një audiencë është mënyrë grupimi kontaktesh, jo listë abonimi, dhe vendosja e dikujt në një të tillë nuk i dërgon asgjë.
Shtimi i një kontakti në një listë është shkrim te LISTA e jo te kontakti, prandaj kontrollohet nga audiences:write dhe jo nga contacts:write. Leximi i adresave në një audiencë kërkon vetëm audiences:read.