پرش به مستندات
سرور MCP

گروه‌های مخاطب

فهرست‌های نام‌داری که مخاطبان در آن‌ها گروه‌بندی می‌شوند.

ابزارهای گروه‌های مخاطب

ابزارچه می‌کند
listAudiencesفهرست‌هایی که این صندوق مخاطبانش را در آن‌ها گروه‌بندی می‌کند، با فهرست پیش‌فرض در ابتدا. یک گروه مخاطب فقط یک گروه‌بندی است و نه چیز دیگری.
getAudienceیک گروه مخاطب به‌طور کامل: نامش، اینکه برای چیست، چند مخاطب در آن است و آیا پیش‌فرض است یا نه.
createAudienceیک فهرست نام‌دار بسازید. خالی ساخته می‌شود و هیچ چیز جلوی هم‌نام بودن دو گروه مخاطب را نمی‌گیرد، پس نخست فهرست را بخوانید.
updateAudienceنام یک گروه مخاطب را عوض کنید یا شرح کاربردش را تغییر دهید. گروه پیش‌فرض هم مثل بقیه قابل تغییر نام است و هر نامی که داشته باشد پیش‌فرض می‌ماند.
deleteAudienceیک گروه مخاطب را حذف کنید. عضویت‌ها می‌روند، هر مخاطبی که در آن بوده می‌ماند. گروه پیش‌فرض حذف‌شدنی نیست.
listAudienceContactsاینکه چه کسانی در یک گروه مخاطب هستند. درخواست گروه پیش‌فرض همهٔ مخاطبان صندوق را فهرست می‌کند.
addContactToAudienceیک مخاطب موجود را در گروهی بگذارید. هرگز مخاطب نمی‌سازد، چون نشانی‌ای که اشتباه تایپ شده باشد به ردیفی همیشگی تبدیل می‌شد که کسی نخواسته بود.
removeContactFromAudienceیک مخاطب را از گروهی بیرون بیاورید. همچنان مخاطب می‌ماند، با یادداشت‌ها و گروه‌های دیگرش.

هر صندوق یک گروه مخاطب پیش‌فرض دارد که همهٔ مخاطبان در آن هستند، و تنها چیزی اینجاست که نه حذف می‌شود و نه کم می‌شود. بیرون آوردن کسی از آن یعنی مخاطبی که listContacts نشانش می‌دهد و listAudienceContacts نمی‌تواند، که دفترچه‌ای است که با خودش نمی‌خواند. deleteContact همان چیزی است که کسی را به‌کلی از صندوق حذف می‌کند.

هیچ چیزی اینجا به یک گروه مخاطب ایمیل نمی‌فرستد، و ابزاری هم برای این کار نیست. گروه مخاطب راهی برای گروه‌بندی مخاطبان است، نه فهرست اشتراک، و گذاشتن کسی در آن هیچ ایمیلی برایش نمی‌فرستد.

افزودن یک مخاطب به یک فهرست، نوشتن روی خودِ فهرست است نه روی مخاطب، پس پشت audiences:write است و نه contacts:write. خواندن نشانی‌های داخل یک گروه مخاطب تنها به audiences:read نیاز دارد.