Kontakte

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 gibt die zuletzt gesehenen Kontakte zuerst zurück und Kontakte, an die nie gesendet wurde, zuletzt. source ist auto, wenn die Zeile geschrieben wurde, weil ein Mitglied dieser Adresse eine Nachricht aus dem Composer der App gesendet hat, was eine inhaltlich andere Aussage ist als das bewusste Speichern durch jemanden. Eingehende Mail von einer Adresse schreibt nichts, ein Versand über diese API ebenso wenig.

Das Adressbuch gehört dem Workspace und nicht einer einzelnen Person, ein von irgendeinem Mitglied gespeicherter Kontakt ist daher der Kontakt, den jedes Mitglied und jeder Schlüssel sieht. create schreibt source als manual und legt den Kontakt beim Schreiben in die Standard-Audience. Nennen Sie eigene Listen in audienceIds, um sie im selben Aufruf zuzuordnen, was zusätzlich audiences:write erfordert, oder fügen Sie den Kontakt später mit audiences.add_contact hinzu, das die Seite Audiences behandelt. set_audiences legt in einem Aufruf genau fest, in welchen Listen ein Kontakt ist.

contacts.list gibt eine OpenEmail::Page zurück, die Zeilen liegen daher auf page.items, und der Durchlauf folgt page.next_cursor, solange page.has_more? true ist. list_all gibt alle Zeilen als ein einziges Array zurück, und iterate übergibt sie einzeln. get, create, update, save und set_audiences geben jeweils einen Kontakt als Hash mit Symbol-Schlüsseln zurück, dieselbe Zeile plus audiences. Das Adressbuch ist unbegrenzt, deshalb paginiert diese Route, statt ein Array zurückzugeben, das stillschweigend bei 200 endet.

set_audiences(email, audienceIds: [...]) legt in einer Anfrage genau fest, in welchen Audiences ein Kontakt ist. Der Kontakt tritt jeder genannten Audience bei, in der er noch nicht ist, und verlässt jede andere, und der Aufruf gibt den Kontakt nach der Änderung zurück, mit seinen audiences. Er erfordert audiences:write, weil er Mitgliedschaften schreibt und nicht den Kontakt, und eine Wiederholung ändert nichts. Das Gem wiederholt ihn daher nach einem Netzwerkfehler.

list_people listet die Personen, die die Kontaktseite der App zeigt: die gespeicherten Kontakte und jede in Mails gesehene Adresse, jeweils mit saved, threads und lastAt, und gibt eine OpenEmail::PeoplePage zurück, die zu items, has_more? und next_cursor noch seen ergänzt. list liefert dagegen nur die gespeicherten Kontakte. Die in Mails gesehenen Adressen kommen nur, wenn der Schlüssel auch threads:read hat, und page.seen sagt, ob sie gekommen sind. sort: ist recent, name oder threads, und OpenEmail::PEOPLE_SORTS nennt sie. q: durchsucht Namen, Adressen und Notizen, und blocked: true behält die Personen, die die Blockliste des Workspace blockiert, Regeln für ganze Domains eingeschlossen. blockedBy nennt die Regel in jeder Zeile.

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) mit optionalem name: und notes: entspricht Zu Kontakten hinzufügen und In Kontakten behalten: Es speichert eine Adresse, die noch kein Kontakt ist, behält eine aus einem Versand erfasste als von Hand gespeichert und holt eine gelöschte zurück. delete entspricht Löschen: Es entfernt den gespeicherten Kontakt und blendet die Adresse aus, damit der Composer sie nicht wieder erfasst, und nimmt auch eine Adresse, die nur in Mails vorkam. wasSaved im zurückgegebenen Hash sagt, was davon es war. delete_many löscht bis zu 200 in einem Aufruf.

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) setzt die Adresse auf die Blockliste des Workspace, sodass Mails von ihr abgewiesen werden, und lässt ein Plus-Tag weg, und unblock(email) nimmt jede Regel ab, die sie blockiert. Beide brauchen settings:write, weil sie die Blockliste ändern und nicht den Kontakt, und bei keinem muss die Adresse ein Kontakt sein.

list_threads(email) blättert durch die Threads, die die Adresse geschrieben hat oder die an sie gingen, in jedem Ordner, und list_all_threads und iterate_threads durchlaufen sie. activity(email) liefert die Zahlen hinter dem Tab Aktivität eines Kontakts: empfangen und gesendet pro Abschnitt, Threads, die auf Ihre Antwort warten, und die mittlere Antwortzeit in beide Richtungen. Beide brauchen 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)