Danh bạ
Sổ địa chỉ mà hộp thư này viết tới.
Công cụ danh bạ
| Công cụ | Chức năng |
|---|---|
| listContacts | Những người hộp thư này viết tới, thư từ mới nhất trước. Tìm theo tên hoặc địa chỉ, thu hẹp vào một audience, hoặc tách những người do ai đó thêm vào khỏi những người được ghi nhận tự động. |
| getContact | Một liên hệ theo địa chỉ email, kèm toàn bộ ghi chú và mọi audience nó đang nằm trong. |
| createContact | Thêm một liên hệ bằng tay. Mỗi địa chỉ một liên hệ, nên một địa chỉ đã có ở đây sẽ bị từ chối chứ không ghi thành hai bản. Liên hệ mới được đưa vào audience mặc định. |
| updateContact | Đổi tên một liên hệ hoặc phần ghi chú lưu kèm nó. Truyền null sẽ xoá trống một trường, bỏ trường đó ra thì nó giữ nguyên. |
| deleteContact | Xoá vĩnh viễn một liên hệ. Ghi chú mất theo, và mọi audience nó từng nằm trong cũng vậy. |
Danh bạ thuộc về HỘP THƯ chứ không thuộc về người đã lưu chúng, nên một đồng nghiệp giữ cùng vai trò sẽ đọc và ghi cùng một cuốn sổ. Một liên hệ được ghi nhận tự động ở lần đầu tiên một thư đi ra tới một địa chỉ từ trình soạn thư trong ứng dụng; thư đến từ một địa chỉ thì không ghi gì cả.
Địa chỉ chính là danh tính và không có id nào cả. Vì vậy updateContact không đổi được nó, và chuyển ai đó sang địa chỉ mới là một createContact cộng một deleteContact. createContact không nhận source: mọi thứ tạo ở đây đều là manual, và một lần gửi không bao giờ hạ nó về lại auto.
Không phần nào ở đây gửi đi thứ gì hay đăng ký ai vào bất cứ đâu, và deleteContact cũng không huỷ đăng ký của ai, vì hộp thư này hoàn toàn không giữ trạng thái đăng ký nào. Một địa chỉ mà hộp thư vẫn tiếp tục viết tới sẽ được ghi nhận lại ở lần gửi kế tiếp, không ghi chú và không audience nào.