Danh bạ

const page = await openemail.contacts.list({ limit: 100 })  const contact = await openemail.contacts.get('[email protected]')   const saved = await openemail.contacts.create({    email: '[email protected]',    name: 'Grace Hopper',    notes: 'Met at the compiler workshop',  })   await openemail.contacts.update(saved.email, { notes: null })  await openemail.contacts.delete(saved.email)   console.log(page.items.length, page.hasMore, contact.source, contact.lastSeenAt)

Gần đây nhất trước, còn các contact chưa từng được gửi thư thì xếp cuối. source là auto khi bản ghi được tạo do một thành viên đã gửi thư tới địa chỉ đó từ trình soạn thư trong ứng dụng, một khẳng định khác hẳn về bản chất so với việc ai đó chủ động lưu nó. Thư đến từ một địa chỉ không ghi gì cả, và một lần gửi qua API này cũng vậy.

Danh bạ thuộc về workspace chứ không thuộc về một cá nhân, nên một contact do bất kỳ thành viên nào lưu là contact mà mọi thành viên và mọi key đều thấy. create ghi source là manual và đưa contact vào audience mặc định ngay khi ghi. Hãy nêu các danh sách của riêng bạn trong audienceIds để thêm vào chúng trong cùng lệnh gọi, việc này cũng cần audiences:write, hoặc thêm contact sau bằng openemail.audiences.addContact.

contacts.list phân giải ra một Page<ContactResource>, nên các dòng nằm trong page.items và việc duyệt đi theo page.nextCursor chừng nào page.hasMore còn là true. get, create và update mỗi cái phân giải ra một ContactDetailResource, tức cùng bản ghi đó cộng thêm audiences. Danh bạ không giới hạn kích thước, và đó là lý do route này phân trang thay vì trả về một mảng âm thầm dừng ở 200 dòng.