Threads

Die API paginiert Threads mit einem pageToken. Der Client reicht ihn als nextCursor heraus und nimmt ihn als cursor wieder entgegen, wie bei jeder anderen Liste, und list_all sowie iterate folgen ihm automatisch. Er ist opak: Zurückgegeben wird genau der erhaltene Wert; ein Token darf nie selbst gebaut werden.

sort, date_from, date_to und from_contacts sind die Steuerelemente der Threadliste selbst. sort ist newest, oldest, sender oder subject, die Datumswerte nehmen ein datetime oder einen ISO-8601-String und schließen beide Enden ein, und from_contacts behält Mail, deren neueste Nachricht von einem gespeicherten Kontakt kam. Jede Sortierung lässt sich bis zum Ende blättern, ohne einen Thread zu überspringen oder zu wiederholen. Ein datetime ohne tzinfo wird als Ortszeit gelesen.

addLabelIds nimmt IDs aus labels.list und die System-IDs wie ARCHIVE und STARRED. Eine ID, die kein Label benennt, wird mit 422 label_not_found abgelehnt statt angelegt, legen Sie das Label also zuerst mit labels.create an. threads.list(folder='USER_DONE') listet jeden Thread mit einem Label, egal in welchem Ordner.

content ist base64 und ein leerer String, wenn die gespeicherten Bytes nicht gefunden werden konnten; vor dem Dekodieren sollte daher die Länge geprüft werden. Der Ciphertext einer verschlüsselten Nachricht STEHT in dieser Liste und wird wie jede andere Datei heruntergeladen; der Versions-Part von PGP/MIME und eine etwaige abgetrennte Signatur dagegen nicht. Sie behalten ihre ids in encryption.parts und sonst nichts.

Verzweigt wird über is_sealed, nie über das Vorhandensein des Feldes. Zwei der fünf Formate, pgp-signed und smime-signed, beschreiben einen Body, der IM KLARTEXT neben einer abgetrennten Signatur eingegangen ist; eine Prüfung auf bloßes Vorhandensein verbirgt also Mail, die niemand verbergen musste, und die Nutzerin oder der Nutzer kann sie weder sehen noch erklären. Genau dafür gibt es is_sealed: Der Server nennt die versiegelte Menge einmal, und eine dritte, aus der Union abgeschriebene Kopie ist die, die auseinanderdriftet.

Fehlen bedeutet nicht Klartext. encryption fehlt bei jeder Nachricht, die vor dem Ausliefern der Erkennung gespeichert wurde, und bei allem, was das Postfach über einen Weg erreicht hat, auf dem der Detektor nie lief. Es hält fest, dass niemand nachgesehen hat – eine Tatsache über unsere Abdeckung und nicht über die Mail –, und nichts trägt es nachträglich nach.