مخاطبان
دفترچهنشانیای که این صندوق به آن مینویسد.
ابزارهای مخاطبان
| ابزار | چه میکند |
|---|---|
| listContacts | کسانی که این صندوق به آنها مینویسد، با تازهترین مکاتبه در ابتدا. با نام یا نشانی جستوجو کنید، به یک گروه مخاطب محدود کنید، یا آنهایی را که کسی افزوده از آنهایی که خودکار ثبت شدهاند جدا کنید. |
| getContact | یک مخاطب بر پایهٔ نشانی ایمیل، با یادداشتهایش بهطور کامل و هر گروه مخاطبی که در آن است. |
| createContact | یک مخاطب را دستی بیفزایید. برای هر نشانی یک مخاطب، پس نشانیای که از پیش اینجاست بهجای اینکه دوبار نوشته شود رد میشود. مخاطب تازه به گروه پیشفرض میپیوندد. |
| updateContact | نام یک مخاطب یا یادداشتهای نگهداشتهشده برایش را تغییر دهید. فرستادن null یک فیلد را پاک میکند، نفرستادنش آن را دستنخورده میگذارد. |
| deleteContact | یک مخاطب را برای همیشه حذف کنید. یادداشتها با آن میروند، و هر گروه مخاطبی هم که در آن بوده. |
مخاطبان به صندوق تعلق دارند نه به کسی که ذخیرهشان کرده، پس همکاری که همان نقش را دارد همان دفترچه را میخواند و مینویسد. مخاطب نخستین باری که از نگارشگر برنامه پیامی به یک نشانی بیرون میرود خودکار ثبت میشود؛ ایمیلی که از یک نشانی میرسد چیزی نمینویسد.
نشانی همان هویت است و شناسهای در کار نیست. پس updateContact نمیتواند آن را عوض کند، و بردن کسی به نشانی تازه یعنی یک createContact و یک deleteContact. createContact هیچ sourceای نمیگیرد: هر چیزی که اینجا ساخته شود manual است، و ارسال هرگز آن را به auto پایین نمیآورد.
هیچکدام از اینها چیزی نمیفرستد و کسی را مشترک چیزی نمیکند، و deleteContact اشتراک کسی را لغو نمیکند، چون این صندوق اصلاً هیچ حالت اشتراکی نگه نمیدارد. نشانیای که صندوق همچنان به آن مینویسد در ارسال بعدی دوباره ثبت میشود، بیهیچ یادداشت و بیهیچ گروه مخاطبی.