Contacts

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 renvoie d'abord les contacts vus le plus récemment, et en dernier les contacts à qui rien n'a jamais été envoyé. source vaut auto quand la ligne a été écrite parce qu'un membre a envoyé un message à cette adresse depuis le compositeur de l'application, ce qui est une affirmation sensiblement différente de « quelqu'un l'a enregistrée ». Le courrier qui arrive d'une adresse n'écrit rien, et un envoi via cette API non plus.

Le carnet appartient à l'espace de travail plutôt qu'à une personne : un contact enregistré par un membre est donc le contact que voient tous les membres et toutes les clés. create écrit source à manual et place le contact dans l'audience par défaut au moment de l'écriture. Nommez vos propres listes dans audienceIds pour l'y ajouter dans le même appel, ce qui exige aussi audiences:write, ou ajoutez le contact plus tard avec audiences.add_contact, que couvre la page Audiences. set_audiences indique exactement dans quelles listes se trouve un contact, en un seul appel.

contacts.list renvoie une OpenEmail::Page : les lignes sont donc dans page.items et le parcours suit page.next_cursor tant que page.has_more? vaut true. list_all renvoie toutes les lignes dans un seul Array, et iterate les passe une par une. get, create, update, save et set_audiences renvoient chacun un contact sous forme de Hash à clés Symbol, la même ligne plus audiences. Le carnet d'adresses est illimité, c'est pourquoi cette route pagine plutôt que de renvoyer un Array qui s'arrêterait silencieusement à 200.

set_audiences(email, audienceIds: [...]) dit exactement dans quelles audiences se trouve un contact, en une seule requête. Le contact rejoint chaque audience indiquée où il n'est pas encore et quitte toutes les autres, et l'appel renvoie le contact après le changement, avec ses audiences. Il nécessite audiences:write, car il écrit des appartenances et non le contact, et le répéter ne change rien : la gem le réessaie donc après un échec réseau.

list_people liste les personnes que montre la page Contacts de l'application : les contacts enregistrés et chaque adresse vue dans le courrier, chacune avec saved, threads et lastAt, et renvoie une OpenEmail::PeoplePage, qui ajoute seen à items, has_more? et next_cursor. list ne donne en revanche que les contacts enregistrés. Les adresses vues dans le courrier ne viennent que si la clé détient aussi threads:read, et page.seen dit si c'est le cas. sort: vaut recent, name ou threads, et OpenEmail::PEOPLE_SORTS les nomme. q: cherche dans les noms, les adresses et les notes, et blocked: true garde les personnes que bloque la liste de blocage de l'espace de travail, règles sur des domaines entiers comprises. blockedBy nomme la règle sur chaque ligne.

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), avec name: et notes: optionnels, correspond à Ajouter aux contacts et Garder dans les contacts : il enregistre une adresse qui n'est pas encore un contact, garde comme enregistrée à la main une adresse relevée lors d'un envoi, et ramène une adresse supprimée. delete correspond à Supprimer : il retire le contact enregistré et masque l'adresse, pour que le compositeur ne l'enregistre plus, et il accepte aussi une adresse seulement vue dans le courrier. wasSaved, dans le Hash qu'il renvoie, indique de quel cas il s'agissait. delete_many en supprime jusqu'à 200 en un seul appel.

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) met l'adresse sur la liste de blocage de l'espace de travail pour que son courrier soit refusé, en retirant toute étiquette plus, et unblock(email) retire chaque règle qui la bloque. Les deux demandent settings:write, car ils modifient la liste de blocage et non le contact, et aucun n'exige que l'adresse soit un contact.

list_threads(email) parcourt page par page les fils que l'adresse a écrits ou qui lui ont été écrits, dans tous les dossiers, et list_all_threads et iterate_threads les parcourent entièrement. activity(email) renvoie les chiffres derrière l'onglet Activité d'un contact : reçus et envoyés par intervalle, fils qui attendent votre réponse, et temps de réponse médian dans chaque sens. Les deux demandent 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)