In der Gmail API werden Thread
-Ressourcen verwendet, um E-Mail-Antworten mit der ursprünglichen Nachricht in einer einzigen Unterhaltung oder einem Thread zu gruppieren. Auf diese Weise können Sie alle Nachrichten in einer Konversation in der angegebenen Reihenfolge abrufen, was es einfacher macht, Kontext für eine Nachricht zu haben oder die Suchergebnisse zu verfeinern.
Wie Nachrichten können Threads auch Labels haben. Im Gegensatz zu 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
Threads sind eine einfache Möglichkeit, Nachrichten in einer Unterhaltung der Reihe nach abzurufen.
Durch die Auflistung einer Reihe von Threads können Sie Nachrichten nach Konversation gruppieren und zusätzlichen Kontext bereitstellen. Sie können eine Liste von Threads mit der Methode threads.list
oder einen bestimmten Thread mit threads.get
abrufen. Sie können auch Threads filtern, indem Sie dieselben Abfrageparameter wie für die Message
-Ressource verwenden. Wenn eine Nachricht in einem Thread mit der Abfrage übereinstimmt, wird dieser Thread im Ergebnis zurückgegeben.
Das folgende Codebeispiel zeigt, wie beide Methoden in einem Beispiel verwendet werden, das die meisten Chat-Threads in Ihrem Posteingang anzeigt. Die Methode threads.list
ruft alle Thread-IDs ab, dann threads.get
alle Nachrichten in jedem Thread.
Bei drei oder mehr Antworten extrahieren wir die Zeile Subject
und zeigen die nicht leeren sowie die Anzahl der Nachrichten im Thread an. Dieses Codebeispiel ist auch im entsprechenden DevByte-Video zu finden.
Python
Entwürfe und Nachrichten zu Threads hinzufügen
Wenn Sie Nachrichten senden oder migrieren, die eine Antwort auf eine andere E-Mail oder einen Teil einer Konversation sind, sollte Ihre Anwendung diese Nachricht dem zugehörigen Thread hinzufügen. Dies erleichtert es Gmail-Nutzern, die an der Unterhaltung beteiligt sind, die Nachricht im Kontext zu behalten.
Ein Entwurf kann einem Thread beim Erstellen, Aktualisieren oder Senden eines Nachrichtenentwurfs hinzugefügt werden. Sie können einem Thread auch eine Nachricht hinzufügen, wenn Sie eine Nachricht einfügen oder senden.
Nachrichten oder Entwürfe müssen folgende Kriterien erfüllen, um Teil eines Threads zu werden:
- Die angeforderte
threadId
muss in derMessage
oderDraft.Message
angegeben werden, die Sie mit Ihrer Anfrage angeben. - Die Header
References
undIn-Reply-To
müssen gemäß dem RFC 2822-Standard 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.