Mit E‑Mail-Reaktionen können Nutzer auf E‑Mails auf unterhaltsame und unkomplizierte Weise mit Emojis antworten.
Format
Eine E‑Mail-Reaktion ist eine normale E‑Mail im MIME-Format mit einem speziellen Teil, der angibt, dass es sich um eine Reaktion handelt.
Allgemeines Nachrichtenformat
Die E‑Mail muss einen Textteil mit Content-Type:
text/vnd.google.email-reaction+json haben, der wie in der
Definition beschrieben formatiert ist.
Ein Textteil ist entweder:
- Der Teil der Nachricht auf oberster Ebene. Das bedeutet, dass der
Content-Type-Header der E‑Mailtext/vnd.google.email-reaction+jsonist. - Ein Unterteil eines mehrteiligen MIME-Teils mit einem
Content-Typevontext/vnd.google.email-reaction+jsonund einemContent-Disposition, das nichtattachmentist.
Die E‑Mail mit der Reaktion sollte auch normale text/plain- und text/html-Teile haben, damit in E‑Mail-Clients, die keine E‑Mail-Reaktionen unterstützen, trotzdem eine Antwort angezeigt wird. In Gmail wird empfohlen, den text/vnd.google.email-reaction+json-Teil zwischen die text/plain- und text/html-Teile zu setzen. Das liegt daran, dass einige E‑Mail-Clients immer den letzten Teil anzeigen, unabhängig davon, ob sie den MIME-Typ tatsächlich verstehen. Ebenso zeigen einige E‑Mail-Clients nur den ersten Teil an.
Die E‑Mail sollte auch einen In-Reply-To-Header mit der Nachrichten-ID der Nachricht enthalten, auf die sich die Reaktion bezieht. Dies muss eine einzelne Nachrichten-ID sein.
Definition des text/vnd.google.email-reaction+json-Teils
Dieser MIME-Teil hat das JSON-Format. Er enthält zwei Felder:
version: Eine Ganzzahl, die die Version des E‑Mail-Reaktionsformats darstellt, dem dieser Teil entspricht. Sie muss1sein.emoji: Ein String, der genau ein Emoji-Symbol darstellt, wie in dem Unicode Technical Standard 51 definiert.
Wenn die Content-Transfer-Encoding ein binäres Format ist, muss JSON die UTF-8-Zeichencodierung verwenden. Andernfalls kann die Content-Transfer-Encoding eine beliebige Standardcodierung sein.
Interpretation von text/vnd.google.email-reaction+json in Gmail
Wenn Gmail eine Nachricht erhält, die wie eine Reaktion aussieht, wird der Reaktionsteil validiert und die Nachricht wird speziell angezeigt.
Validierung
Gmail validiert alle Nachrichten mit einem text/vnd.google.email-reaction+json-Teil, die empfangen werden. Wenn der Teil fehlerhaft ist, gilt er als ungültig und die Nachricht wird nicht als Reaktion behandelt.
Wichtig ist insbesondere:
Gmail parst das JSON und prüft seine Gültigkeit. Wenn das JSON fehlerhaft ist, gilt der Teil in Gmail als ungültig.
Gmail prüft das Feld „Version“. Die Version muss genau 1 sein. Sie muss eine Ganzzahl sein und darf kein String sein. Im Laufe der Zeit werden möglicherweise andere Versionen akzeptiert. Wenn die Version unbekannt ist oder fehlt, gilt der Teil in Gmail als ungültig.
Gmail prüft das Feld „Emoji“. Der Inhalt muss genau eines der Emojis sein, die in Version 15 oder höher des Unicode Technical Standard 51 angegeben sind, einschließlich aller referenzierten Erweiterungen wie Hautfarbe. Da sich der Emoji-Standard weiterentwickelt, wird in Gmail mindestens die neueste Version minus 1 unterstützt. Gmail unterstützt wahrscheinlich die neueste Version, mit Ausnahme des Zeitraums, der für die Implementierung eines neu veröffentlichten Standards erforderlich ist. Wenn das Feld fehlt, leer ist oder nicht genau ein Emoji enthält, gilt der Teil in Gmail als ungültig.
Display
Bei Nachrichten mit gültigen E‑Mail-Reaktionsteilen wird das Emoji im Feld „Emoji“ neben der Nachricht angezeigt, die durch den In-Reply-To-Header angegeben wird. Möglicherweise wird auch die Anzahl der Reaktionen mit diesem Emoji angezeigt, der Absender dieser Reaktion und möglicherweise andere UI-Elemente. Wenn der In-Reply-To-Header fehlt oder eine Nachricht mit der angegebenen ID nicht im Unterhaltungsthread gefunden werden kann, wird die Reaktionsnachricht in Gmail als normale E‑Mail angezeigt. Möglicherweise kann Gmail die Nachricht nicht finden, weil der Nutzer sie gelöscht hat, der Thread zu lang geworden ist oder aus anderen Gründen.
Beim Anzeigen ungültiger E‑Mail-Reaktionsnachrichten wird in Gmail der text/html-Teil angezeigt, sofern vorhanden. Andernfalls wird der text/plain-Teil verwendet. Wenn keiner dieser Textteile vorhanden ist, wird in Gmail eine leere Nachricht angezeigt.
Limits
In Gmail wird empfohlen, dass Clients, die Unterstützung für E‑Mail-Reaktionen hinzufügen möchten, einige Limits festlegen, um zu verhindern, dass Nutzer von Reaktionen überfordert werden. Wichtig ist insbesondere:
- Für Nachrichten von Mailinglisten sollten keine Reaktionen zulässig sein.
- Für Nachrichten mit zu vielen Empfängern sollten keine Reaktionen zulässig sein. (In Gmail gilt ein
Limit von 20 verschiedenen Empfängern in den kombinierten Feldern
ToundCC.) - Für Nachrichten, bei denen der Empfänger nicht in den Feldern
TooderCCenthalten ist, sollten keine Reaktionen zulässig sein. - Für Nachrichten, die bereits viele Reaktionen haben, sollten keine Reaktionen zulässig sein. (In Gmail gilt ein Limit von 20 Reaktionen pro Nutzer für eine Nachricht.)
Diese und andere Limits werden auch im Abschnitt „Emoji -Reaktionen können nicht gesendet werden“ unter Mit Emoji -Reaktionen auf E‑Mails antworten beschrieben.