ऑडियंस
नामित सूचियाँ जिनमें संपर्क समूहबद्ध होते हैं।
ऑडियंस टूल
| टूल | यह क्या करता है |
|---|---|
| listAudiences | वे सूचियाँ जिनमें यह मेलबॉक्स अपने संपर्कों को समूहबद्ध करता है, डिफ़ॉल्ट सूची सबसे पहले। ऑडियंस सिर्फ़ एक समूहन है, और कुछ नहीं। |
| getAudience | एक ऑडियंस पूरी तरह: उसका नाम, वह किसलिए है, उसमें कितने संपर्क हैं और वह डिफ़ॉल्ट है या नहीं। |
| createAudience | एक नामित सूची बनाएँ। यह खाली बनती है, और दो ऑडियंस का एक ही नाम रखना कोई चीज़ नहीं रोकती, इसलिए पहले सूची पढ़ लें। |
| updateAudience | किसी ऑडियंस का नाम बदलें या वह किसलिए है यह बदलें। डिफ़ॉल्ट ऑडियंस का नाम भी किसी और की तरह बदला जा सकता है और नाम चाहे जो हो, वह डिफ़ॉल्ट ही रहती है। |
| deleteAudience | कोई ऑडियंस मिटाएँ। सदस्यता चली जाती है, उसमें रहा हर संपर्क बना रहता है। डिफ़ॉल्ट ऑडियंस मिटाई नहीं जा सकती। |
| listAudienceContacts | किसी एक ऑडियंस में कौन है। डिफ़ॉल्ट ऑडियंस माँगने पर मेलबॉक्स का हर संपर्क सूचीबद्ध होता है। |
| addContactToAudience | किसी मौजूदा संपर्क को किसी ऑडियंस में डालें। यह कभी संपर्क नहीं बनाता, क्योंकि गलत टाइप किया गया पता ऐसी स्थायी पंक्ति बन जाता जिसे किसी ने माँगा ही नहीं। |
| removeContactFromAudience | किसी संपर्क को ऑडियंस से बाहर निकालें। वह अपने नोट्स और अपनी दूसरी ऑडियंस के साथ संपर्क बना रहता है। |
हर मेलबॉक्स में एक डिफ़ॉल्ट ऑडियंस होती है जिसमें हर संपर्क रहता है, और यहाँ यही एक चीज़ है जिसे न मिटाया जा सकता है और न घटाया जा सकता है। किसी को उसमें से निकालने का मतलब होगा ऐसा संपर्क जो listContacts दिखाता है और listAudienceContacts नहीं दिखा सकता, यानी ऐसी किताब जो खुद से ही असहमत है। किसी को मेलबॉक्स से पूरी तरह हटाने का काम deleteContact करता है।
यहाँ कुछ भी किसी ऑडियंस को मेल नहीं भेजता, और ऐसा कोई टूल है ही नहीं। ऑडियंस संपर्कों को समूहबद्ध करने का तरीका है, सब्सक्रिप्शन सूची नहीं, और किसी को उसमें डालने से उसे कोई मेल नहीं जाता।
किसी संपर्क को सूची में जोड़ना संपर्क पर नहीं, बल्कि सूची पर लिखना है, इसलिए यह contacts:write नहीं, audiences:write के पीछे है। किसी ऑडियंस के पते पढ़ने के लिए सिर्फ़ audiences:read चाहिए।