سرور MCP
گروههای مخاطب
فهرستهای نامداری که مخاطبان در آنها گروهبندی میشوند.
ابزارهای گروههای مخاطب
| ابزار | چه میکند |
|---|---|
| listAudiences | فهرستهایی که این صندوق مخاطبانش را در آنها گروهبندی میکند، با فهرست پیشفرض در ابتدا. یک گروه مخاطب فقط یک گروهبندی است و نه چیز دیگری. |
| getAudience | یک گروه مخاطب بهطور کامل: نامش، اینکه برای چیست، چند مخاطب در آن است و آیا پیشفرض است یا نه. |
| createAudience | یک فهرست نامدار بسازید. خالی ساخته میشود و هیچ چیز جلوی همنام بودن دو گروه مخاطب را نمیگیرد، پس نخست فهرست را بخوانید. |
| updateAudience | نام یک گروه مخاطب را عوض کنید یا شرح کاربردش را تغییر دهید. گروه پیشفرض هم مثل بقیه قابل تغییر نام است و هر نامی که داشته باشد پیشفرض میماند. |
| deleteAudience | یک گروه مخاطب را حذف کنید. عضویتها میروند، هر مخاطبی که در آن بوده میماند. گروه پیشفرض حذفشدنی نیست. |
| listAudienceContacts | اینکه چه کسانی در یک گروه مخاطب هستند. درخواست گروه پیشفرض همهٔ مخاطبان صندوق را فهرست میکند. |
| addContactToAudience | یک مخاطب موجود را در گروهی بگذارید. هرگز مخاطب نمیسازد، چون نشانیای که اشتباه تایپ شده باشد به ردیفی همیشگی تبدیل میشد که کسی نخواسته بود. |
| removeContactFromAudience | یک مخاطب را از گروهی بیرون بیاورید. همچنان مخاطب میماند، با یادداشتها و گروههای دیگرش. |
هر صندوق یک گروه مخاطب پیشفرض دارد که همهٔ مخاطبان در آن هستند، و تنها چیزی اینجاست که نه حذف میشود و نه کم میشود. بیرون آوردن کسی از آن یعنی مخاطبی که listContacts نشانش میدهد و listAudienceContacts نمیتواند، که دفترچهای است که با خودش نمیخواند. deleteContact همان چیزی است که کسی را بهکلی از صندوق حذف میکند.
هیچ چیزی اینجا به یک گروه مخاطب ایمیل نمیفرستد، و ابزاری هم برای این کار نیست. گروه مخاطب راهی برای گروهبندی مخاطبان است، نه فهرست اشتراک، و گذاشتن کسی در آن هیچ ایمیلی برایش نمیفرستد.
افزودن یک مخاطب به یک فهرست، نوشتن روی خودِ فهرست است نه روی مخاطب، پس پشت audiences:write است و نه contacts:write. خواندن نشانیهای داخل یک گروه مخاطب تنها به audiences:read نیاز دارد.