In der Gmail API werden Thread
-Ressourcen verwendet, um E-Mail-Antworten mit der ursprünglichen Nachricht in einer einzigen Konversation oder einem Thread zu gruppieren. So können Sie alle Nachrichten in einer Unterhaltung in der richtigen Reihenfolge abrufen, was es einfacher macht, den Kontext einer Nachricht zu verstehen oder Suchergebnisse zu verfeinern.
Wie bei Nachrichten können auch Threads mit Labels versehen werden. Anders als bei Nachrichten können Threads jedoch nicht erstellt, sondern nur gelöscht werden. Nachrichten können jedoch in einen Thread eingefügt werden.
Inhalt
Threads abrufen
Mit Threads können Sie Nachrichten in einer Unterhaltung ganz einfach in der richtigen Reihenfolge abrufen.
Wenn Sie eine Reihe von Threads auflisten, können Sie Nachrichten nach Unterhaltung gruppieren und zusätzlichen Kontext bereitstellen. Mit der Methode threads.list
können Sie eine Liste von Threads abrufen. Mit threads.get
können Sie einen bestimmten Thread abrufen. Sie können Threads auch filtern. Verwenden Sie dazu dieselben Suchparameter wie für die Message
-Ressource. Wenn eine Nachricht in einem Thread der Abfrage entspricht, wird dieser Thread im Ergebnis zurückgegeben.
Das folgende Codebeispiel zeigt, wie Sie beide Methoden in einem Beispiel verwenden, in dem die Threads mit den meisten Nachrichten in Ihrem Posteingang angezeigt werden. Mit der Methode threads.list
werden alle Thread-IDs abgerufen. Anschließend werden mit threads.get
alle Nachrichten in den einzelnen Threads abgerufen.
Bei Threads mit mindestens drei Antworten wird die Subject
-Zeile extrahiert und die nicht leeren Zeilen sowie die Anzahl der Nachrichten im Thread werden angezeigt. Dieses Codebeispiel wird auch im entsprechenden DevByte-Video gezeigt.
Python
Threads Entwürfe und Nachrichten hinzufügen
Wenn Sie Nachrichten senden oder migrieren, die eine Antwort auf eine andere E‑Mail oder Teil einer Unterhaltung sind, sollte Ihre Anwendung diese Nachricht dem entsprechenden Thread hinzufügen. So können Gmail-Nutzer, die an der Unterhaltung teilnehmen, die Nachricht leichter im Kontext sehen.
Ein Entwurf kann einem Thread hinzugefügt werden, wenn Sie eine Entwurfsnachricht erstellen, aktualisieren oder senden. Sie können einem Thread auch eine Nachricht hinzufügen, wenn Sie eine Nachricht einfügen oder senden.
Damit eine Nachricht oder ein Entwurf Teil eines Threads sein kann, müssen die folgenden Kriterien erfüllt sein:
- Die angeforderte
threadId
muss auf demMessage
oderDraft.Message
angegeben sein, das Sie mit Ihrer Anfrage einreichen. - Die Header
References
undIn-Reply-To
müssen gemäß dem Standard RFC 2822 festgelegt werden. - Die
Subject
-Header müssen übereinstimmen.
Sehen Sie sich die Beispiele zum Erstellen eines Entwurfs oder zum Senden einer Nachricht an. In beiden Fällen fügen Sie den Metadaten einer Nachricht, dem message
-Objekt, einfach einen threadId
-Schlüssel mit einer Thread-ID hinzu.