연락처

from openemail import openemail page = openemail.contacts.list(limit=100)contact = openemail.contacts.get('[email protected]') saved = openemail.contacts.create({    'email': '[email protected]',    'name': 'Grace Hopper',    'notes': 'Met at the compiler workshop',}) openemail.contacts.update(saved['email'], {'notes': None})openemail.contacts.set_audiences(saved['email'], {    'audienceIds': ['aud_4c1b8e2a7d9f05c36b4e8a71'],})openemail.contacts.delete(saved['email']) print(len(page['items']), page['hasMore'], contact['source'], contact['lastSeenAt'])

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

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

contacts.list는 Page[ContactResource]를 반환하므로 행은 page['items']에 있고, page['hasMore']가 True인 동안 page['nextCursor']를 따라가며, list_all과 iterate가 이를 대신해 줍니다. get, create, save, update, set_audiences, set_photo, remove_photo는 각각 같은 행에 audiences가 더해진 ContactDetailResource 하나를 반환합니다. 주소록에는 상한이 없으며, 그래서 이 경로는 조용히 200행에서 멈추는 리스트 대신 페이징을 합니다.

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

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

from openemail import openemail page = openemail.contacts.list_people(sort='threads', limit=50) for person in page['items']:    if not person['saved'] and (person['threads'] or 0) > 5:        openemail.contacts.save(person['email']) blocked = openemail.contacts.list_all_people(blocked=True)

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

from pathlib import Path from openemail import openemail openemail.contacts.save('[email protected]', {'name': 'Grace Hopper'}) photo = Path('grace.jpg').read_bytes()contact = openemail.contacts.set_photo('[email protected]', photo, content_type='image/jpeg') openemail.contacts.remove_photo('[email protected]')openemail.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가 필요합니다.

import time from openemail import openemail threads = openemail.contacts.list_threads('[email protected]', q='invoice') activity = openemail.contacts.activity(    '[email protected]',    minutes=30 * 24 * 60,    grain='day',    offset_minutes=time.localtime().tm_gmtoff // 60,) print(len(threads['items']), activity['totals']['waiting'])

• contacts.list()전체 레퍼런스
• contacts.list_all()전체 레퍼런스
• contacts.iterate()전체 레퍼런스
• contacts.get()전체 레퍼런스
• contacts.create()전체 레퍼런스
• contacts.save()전체 레퍼런스
• contacts.update()전체 레퍼런스
• contacts.set_audiences()전체 레퍼런스
• contacts.delete()전체 레퍼런스
• contacts.delete_many()전체 레퍼런스
• contacts.list_people()전체 레퍼런스
• contacts.list_all_people()전체 레퍼런스
• contacts.iterate_people()전체 레퍼런스
• contacts.set_photo()전체 레퍼런스
• contacts.remove_photo()전체 레퍼런스
• contacts.block()전체 레퍼런스
• contacts.unblock()전체 레퍼런스
• contacts.list_threads()전체 레퍼런스
• contacts.list_all_threads()전체 레퍼런스
• contacts.iterate_threads()전체 레퍼런스
• contacts.activity()전체 레퍼런스