連絡先

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)

直近に見かけた順で、一度もメールを送っていない連絡先は末尾になります。source が auto なのは、メンバーがアプリのコンポーザーからそのアドレスにメッセージを送ったために行が書かれた場合で、これは誰かが保存したという主張とは意味が大きく異なります。アドレスからメールが届いても何も書かれませんし、この API 経由の送信でも書かれません。

アドレス帳は個人ではなくワークスペースに属するので、どのメンバーが保存した連絡先も、すべてのメンバーとすべてのキーから見える同じ連絡先です。create は source を manual として書き込み、書き込みと同時に連絡先を既定オーディエンスに入れます。独自のリストは audienceIds に指定すれば同じ呼び出しで参加させられますが、これには audiences:write も必要です。あるいは後から openemail.audiences.addContact で追加してください。

contacts.list は Page<ContactResource> に解決されるので、行は page.items にあり、page.hasMore が true の間は page.nextCursor をたどります。get、create、update はそれぞれ 1 件の ContactDetailResource、つまり同じ行に audiences を加えたものに解決されます。アドレス帳に上限はなく、だからこの経路は、黙って 200 件で止まる配列ではなくページングを行います。