Контакты

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['nextCursor'], пока page['hasMore'] равно True, и list_all и iterate делают это за вас. get, create, save, update, set_audiences, set_photo и remove_photo возвращают по одному ContactDetailResource: ту же строку плюс audiences. Адресная книга не ограничена по размеру, поэтому этот маршрут листается постранично, а не возвращает список, который молча обрывается на 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()Полный справочник