Kontakte

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'])

Zuletzt gesehene zuerst, Kontakte ohne je versendete Mail 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 openemail.audiences.add_contact hinzu. set_audiences legt in einem Aufruf genau fest, in welchen Listen ein Kontakt ist.

contacts.list gibt eine Page[ContactResource] zurück, die Zeilen stehen also in page['items'], und der Durchlauf folgt page['nextCursor'], solange page['hasMore'] True ist, was list_all und iterate für Sie erledigen. get, create, save, update, set_audiences, set_photo und remove_photo geben jeweils eine ContactDetailResource zurück, dieselbe Zeile plus audiences. Das Adressbuch ist unbegrenzt, deshalb paginiert diese Route, statt eine Liste zurückzugeben, die stillschweigend bei 200 aufhört.

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 die ContactDetailResource nach der Änderung zurück. Er erfordert audiences:write, weil er Mitgliedschaften schreibt und nicht den Kontakt, und eine Wiederholung ändert nichts.

list_people listet die Personen, die die Kontaktseite der App zeigt: die gespeicherten Kontakte und jede Adresse aus den Mails, jeweils mit saved, threads und lastAt. list sind nur die gespeicherten Kontakte. Die Adressen aus den Mails kommen nur, wenn der Schlüssel auch threads:read hat, und page['seen'] sagt, ob sie gekommen sind. sort ist recent, name oder threads, 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.

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': ...}) ist 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 ist Löschen: Es entfernt den gespeicherten Kontakt und blendet die Adresse aus, damit der Editor sie nicht wieder erfasst, und nimmt auch eine Adresse, die nur in Mails vorkam. wasSaved sagt, was davon es war. delete_many löscht bis zu 200 in einem Aufruf.

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) 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 gehen sie durch. activity(email) liefert die Zahlen hinter dem Tab Aktivität eines Kontakts: empfangen und gesendet pro Abschnitt, Threads, die auf deine Antwort warten, und die mittlere Antwortzeit in beide Richtungen. Beide brauchen 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()Vollständige Referenz
• contacts.list_all()Vollständige Referenz
• contacts.iterate()Vollständige Referenz
• contacts.get()Vollständige Referenz
• contacts.create()Vollständige Referenz
• contacts.save()Vollständige Referenz
• contacts.update()Vollständige Referenz
• contacts.set_audiences()Vollständige Referenz
• contacts.delete()Vollständige Referenz
• contacts.delete_many()Vollständige Referenz
• contacts.list_people()Vollständige Referenz
• contacts.list_all_people()Vollständige Referenz
• contacts.iterate_people()Vollständige Referenz
• contacts.set_photo()Vollständige Referenz
• contacts.remove_photo()Vollständige Referenz
• contacts.block()Vollständige Referenz
• contacts.unblock()Vollständige Referenz
• contacts.list_threads()Vollständige Referenz
• contacts.list_all_threads()Vollständige Referenz
• contacts.iterate_threads()Vollständige Referenz
• contacts.activity()Vollständige Referenz