خادم MCP

الجماهير

قوائم مُسمّاة تُجمَّع فيها جهات الاتصال.

أدوات الجماهير

الأداة	ما تفعله
listAudiences	القوائم التي يجمع فيها هذا الصندوق جهات اتصاله، والافتراضية أولًا. والجمهور تجميع لا غير.
getAudience	جمهور واحد بالكامل: اسمه، والغرض منه، وكم جهة اتصال فيه، وهل هو الافتراضي.
createAudience	أنشئ قائمة مُسمّاة. تُنشأ فارغة، ولا شيء يمنع جمهورين من حمل الاسم نفسه، فاقرأ القائمة أولًا.
updateAudience	أعد تسمية جمهور أو غيّر ما يقول إنه الغرض منه. والجمهور الافتراضي يمكن إعادة تسميته كأي جمهور آخر ويبقى الافتراضي مهما كان اسمه.
deleteAudience	احذف جمهورًا. تذهب العضوية، وتبقى كل جهة اتصال كانت فيه. والجمهور الافتراضي لا يمكن حذفه.
listAudienceContacts	من في جمهور واحد. وطلب الجمهور الافتراضي يسرد كل جهة اتصال في الصندوق.
addContactToAudience	ضع جهة اتصال قائمة في جمهور. ولا تنشئ جهة اتصال أبدًا، لأن عنوانًا مكتوبًا بخطأ سيصير صفًّا دائمًا لم يطلبه أحد.
removeContactFromAudience	أخرج جهة اتصال من جمهور. تبقى جهة اتصال، بملاحظاتها وجماهيرها الأخرى.

لكل صندوق بريد جمهور افتراضي يضم كل جهات الاتصال، وهو الشيء الوحيد هنا الذي لا يمكن حذفه ولا تقليمه. فإخراج أحدهم منه يعني جهة اتصال يعرضها listContacts ولا يستطيع listAudienceContacts عرضها، وهذا دفتر يناقض نفسه. وdeleteContact هو ما يزيل أحدهم من الصندوق نهائيًا.

لا شيء هنا يرسل إلى جمهور، ولا توجد أداة تفعل ذلك. فالجمهور طريقة لتجميع جهات الاتصال، لا قائمة اشتراك، ووضع أحدهم في واحد لا يراسله بشيء.

إضافة جهة اتصال إلى قائمة كتابةٌ في القائمة لا في جهة الاتصال، لذا فهي مقيّدة بـ audiences:write لا بـ contacts:write. وقراءة العناوين في جمهور لا تحتاج إلا إلى audiences:read.