연락처

page = client.contacts.list(limit: 100)contact = client.contacts.get("[email protected]") saved = client.contacts.create(  email: "[email protected]",  name: "Grace Hopper",  notes: "Met at the compiler workshop") client.contacts.update("[email protected]", notes: nil)client.contacts.set_audiences("[email protected]", audienceIds: ["aud_4c1b8e2a7d9f05c36b4e8a71"])client.contacts.delete("[email protected]") puts page.items.size, page.has_more?, contact[:source], contact[:lastSeenAt], saved[:source]

list는 가장 최근에 본 연락처부터 반환하며, 한 번도 메일을 보낸 적 없는 연락처가 뒤로 갑니다. source는 멤버가 앱 작성기에서 그 주소로 메시지를 보냈기 때문에 행이 기록된 경우 auto이며, 이는 누군가 직접 저장했다는 것과는 실질적으로 다른 주장입니다. 어떤 주소에서 메일이 도착해도 아무것도 기록되지 않고, 이 API를 통한 발송도 마찬가지입니다.

주소록은 한 사람이 아니라 워크스페이스에 속하므로, 어느 멤버가 저장한 연락처든 모든 멤버와 모든 키가 같은 연락처를 봅니다. create는 source를 manual로 기록하고, 저장하면서 연락처를 기본 오디언스에 넣습니다. 같은 호출에서 직접 만든 목록에 추가하려면 audienceIds에 지정하세요. 여기에는 audiences:write도 필요합니다. 아니면 나중에 audiences.add_contact로 추가하면 되며, 이는 오디언스 페이지에서 다룹니다. set_audiences는 연락처가 어떤 목록에 속할지 한 번의 호출로 정확히 지정합니다.

contacts.list는 OpenEmail::Page를 반환하므로 행은 page.items에 있고, page.has_more?가 true인 동안 page.next_cursor를 따라갑니다. list_all은 모든 행을 하나의 Array로 반환하고, iterate는 하나씩 yield합니다. get, create, update, save, set_audiences는 각각 같은 행에 audiences가 더해진 연락처 하나를 Symbol 키의 Hash로 반환합니다. 주소록에는 상한이 없으며, 그래서 이 경로는 조용히 200행에서 멈추는 Array 대신 페이징을 합니다.

set_audiences(email, audienceIds: [...])는 연락처 하나가 어떤 오디언스에 속할지 한 번의 요청으로 정확히 지정합니다. 연락처는 나열된 오디언스 중 아직 속하지 않은 곳에 모두 들어가고 나머지에서는 모두 빠지며, 호출은 변경 후의 연락처를 audiences와 함께 반환합니다. 연락처가 아니라 멤버십을 쓰므로 audiences:write가 필요하고, 반복해도 아무것도 바뀌지 않으므로 gem은 네트워크 장애 후에 이를 재시도합니다.

list_people은 앱의 연락처 페이지가 보여 주는 사람을 나열합니다: 저장된 연락처와 메일에서 본 모든 주소이며, 각각 saved, threads, lastAt을 가집니다. list는 저장된 연락처뿐입니다. OpenEmail::PeoplePage를 반환하며, 이는 items, has_more?, next_cursor에 seen을 더한 것입니다. 메일에서 본 주소는 키가 threads:read도 가진 경우에만 오며, 왔는지는 page.seen이 알려 줍니다. sort:는 recent, name, threads 중 하나이며, OpenEmail::PEOPLE_SORTS가 이들을 정의합니다. q:는 이름, 주소, 메모를 검색하며, blocked: true는 워크스페이스 차단 목록이 차단하는 사람만 남기고 도메인 전체 규칙도 포함합니다. blockedBy는 각 행에서 그 규칙을 알려 줍니다.

page = client.contacts.list_people(sort: "threads", limit: 50) page.items.each do |person|  client.contacts.save(person[:email]) if !person[:saved] && person[:threads].to_i > 5end blocked = client.contacts.list_all_people(blocked: true)puts page.seen, blocked.size

선택적인 name:과 notes:를 받는 save(email)은 “연락처에 추가”와 “연락처에 유지”에 해당합니다: 아직 연락처가 아닌 주소를 저장하고, 발송에서 기록된 주소는 직접 저장한 것으로 유지하며, 삭제된 주소를 되돌립니다. delete는 “삭제”에 해당합니다: 저장된 연락처를 없애고 주소를 숨겨 작성기가 다시 기록하지 않게 하며, 메일에서만 본 주소도 받습니다. 반환하는 Hash의 wasSaved가 어느 쪽이었는지 알려 줍니다. delete_many는 한 번의 호출로 최대 200개를 삭제합니다.

client.contacts.save("[email protected]", name: "Grace Hopper") contact = client.contacts.set_photo("[email protected]", File.binread("photo.jpg"), content_type: "image/jpeg")puts contact[:photoUrl] client.contacts.set_photo("[email protected]", Pathname("photo.png")) client.contacts.remove_photo("[email protected]")client.contacts.delete_many(["[email protected]", "[email protected]"])

block(email)은 주소를 워크스페이스 차단 목록에 올려 그 주소의 메일을 거부하며 플러스 태그는 버리고, unblock(email)은 그 주소를 차단하는 모든 규칙을 뺍니다. 둘 다 연락처가 아니라 차단 목록을 바꾸므로 settings:write가 필요하며, 어느 쪽도 주소가 연락처일 필요는 없습니다.

list_threads(email)은 그 주소가 쓰거나 그 주소로 쓴 스레드를 모든 폴더에서 한 페이지씩 넘기고, list_all_threads와 iterate_threads는 전부를 훑습니다. activity(email)은 연락처의 활동 탭 뒤에 있는 숫자를 반환합니다: 구간별로 받은 메일과 보낸 메일, 답장을 기다리는 스레드, 양방향 답장 시간의 중앙값입니다. 둘 다 threads:read가 필요합니다.

threads = client.contacts.list_threads("[email protected]", q: "invoice") activity = client.contacts.activity(  "[email protected]",  minutes: 30 * 24 * 60,  grain: "day",  offset_minutes: Time.now.utc_offset / 60) puts threads.items.size, activity.dig(:totals, :waiting)