Контакты

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.next_cursor, пока page.has_more? истинно. list_all возвращает все строки одним Array, а iterate передаёт их по одной. get, create, update, save и set_audiences возвращают по одному контакту как Hash с ключами типа Symbol: та же строка плюс audiences. Адресная книга не ограничена по размеру, поэтому этот маршрут отдаёт данные постранично, а не возвращает Array, который молча обрывается на 200.

set_audiences(email, audienceIds: [...]) одним запросом точно задаёт, в каких аудиториях состоит один контакт. Контакт вступает во все перечисленные аудитории, в которых ещё не состоит, и выходит из всех остальных, а вызов возвращает контакт после изменения вместе с его audiences. Ему нужна audiences:write, потому что он записывает членство, а не сам контакт, и повтор ничего не меняет, поэтому гем повторяет его после сетевого сбоя.

list_people перечисляет людей, которых показывает страница «Контакты» в приложении: сохранённые контакты и каждый адрес из почты, у каждого saved, threads и lastAt, и возвращает OpenEmail::PeoplePage, которая добавляет seen к items, has_more? и next_cursor. list возвращает только сохранённые контакты. Адреса из почты приходят, только если у ключа есть ещё и 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

save(email) с необязательными name: и notes: соответствует действиям «Добавить в контакты» и «Оставить в контактах»: сохраняет адрес, который ещё не является контактом, оставляет записанный при отправке как сохранённый вручную и возвращает удалённый. delete соответствует действию «Удалить»: убирает сохранённый контакт и скрывает адрес, чтобы композер не записал его снова, и принимает также адрес, который встречался только в почте. wasSaved в возвращаемом Hash сообщает, какой это был случай. 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)