Mit E-Mail-Reaktionen können Nutzer auf unterhaltsame und einfache Weise mit Emojis auf E-Mails reagieren.
Format
Eine E-Mail-Reaktion ist eine normale MIME-formatierte E-Mail mit einem speziellen Teil, der angibt, dass es sich um eine Reaktion handelt.
Gesamtes Nachrichtenformat
Die E-Mail muss einen Textteil mit Content-Type:
text/vnd.google.email-reaction+json
enthalten, der gemäß der Definition formatiert ist.
Ein Körperteil ist entweder:
- Der oberste Teil der Nachricht. Das bedeutet, dass der
Content-Type
-Header der E-Mailtext/vnd.google.email-reaction+json
ist. - Ein Teil eines mehrteiligen MIME-Teils mit der
Content-Type
text/vnd.google.email-reaction+json
und einerContent-Disposition
, die nichtattachment
ist.
Die E-Mail mit der Reaktion sollte auch normale text/plain
- und text/html
-Abschnitte enthalten, damit E-Mail-Clients, die E-Mail-Reaktionen nicht unterstützen, trotzdem eine Antwort sehen. In Gmail wird empfohlen, den text/vnd.google.email-reaction+json
-Teil zwischen den Teilen text/plain
und text/html
zu platzieren. Das liegt daran, dass einige E-Mail-Clients den letzten Teil immer anzeigen, unabhängig davon, ob sie den MIME-Typ tatsächlich verstehen. Einige E-Mail-Clients zeigen ebenfalls nur den ersten Teil an.
Die E-Mail muss außerdem 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.
text/vnd.google.email-reaction+json
Teildefinition
Dieser MIME-Teil ist im JSON-Format. Es enthält zwei Felder:
version
: Eine Ganzzahl, die die Version des E-Mail-Reaktionsformats angibt, der dieser Teil entspricht. Dieser Wert muss1
sein.emoji
: Ein String, der genau ein Emoji-Symbol gemäß Unicode Technical Standard 51 darstellt.
Wenn Content-Transfer-Encoding
ein Binärformat ist, muss JSON die UTF-8-Zeichencodierung verwenden. Andernfalls kann Content-Transfer-Encoding
jede Standardcodierung sein.
Gmail-Interpretation von text/vnd.google.email-reaction+json
Wenn Gmail eine Nachricht empfängt, die wie eine Reaktion aussieht, wird der Reaktionsteil validiert und die Nachricht wird entsprechend dargestellt.
Validierung
Gmail validiert alle Nachrichten mit einem text/vnd.google.email-reaction+json
-Teil, die es empfängt. Wenn der Teil fehlerhaft ist, wird er als ungültig betrachtet und die Nachricht wird nicht als Reaktion behandelt.
Wichtig ist insbesondere:
Gmail parset die JSON-Datei und prüft ihre Gültigkeit. Wenn das JSON-Format fehlerhaft ist, betrachtet Gmail den Teil als ungültig.
In Gmail wird das Versionsfeld geprüft. Die Version muss genau 1 sein. Es muss sich um eine Ganzzahl handeln. Mit der Weiterentwicklung des Formats werden möglicherweise auch andere Versionen akzeptiert. Wenn die Version unbekannt oder fehlt, betrachtet Gmail den Teil als ungültig.
Gmail prüft das Emoji-Feld. 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 Hautton. Gmail unterstützt mindestens die neueste Version 1 des Emoji-Standards. 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, wird der Teil in Gmail als ungültig betrachtet.
Display
Bei Nachrichten mit gültigen Emoji-Reaktionsteilen wird das Emoji in Gmail im Emoji-Feld in der Nähe der Nachricht angezeigt, die durch die In-Reply-To
-Überschrift angegeben ist. Dies kann auch eine Aufzählung der Anzahl der Reaktionen mit diesem Emoji enthalten, den Absender dieser Reaktion und möglicherweise andere UI-Elemente. Wenn der In-Reply-To
-Header fehlt oder eine Nachricht mit der angegebenen ID im Konversations-Thread nicht gefunden werden kann, wird die Reaktionsnachricht in Gmail als normale E-Mail angezeigt. Es kann sein, dass Gmail die Nachricht nicht finden kann, weil der Nutzer sie gelöscht hat, der Thread zu lang geworden ist oder aus anderen Gründen.
Wenn in Gmail Nachrichten zu ungültigen E-Mail-Reaktionen angezeigt werden, wird der Teil text/html
angezeigt, falls vorhanden. Andernfalls wird der Teil text/plain
verwendet. Wenn kein Textteil mit einer dieser Angaben vorhanden ist, zeigt Gmail eine leere Nachricht an.
Limits
Gmail empfiehlt Kunden, die die Unterstützung für E-Mail-Reaktionen hinzufügen möchten, einige Einschränkungen festzulegen, damit Nutzer nicht von zu vielen Reaktionen überwältigt werden. Wichtig ist insbesondere:
- Bei Nachrichten von Mailinglisten sollten keine Reaktionen möglich sein.
- Bei Nachrichten mit zu vielen Empfängern sollten keine Reaktionen möglich sein. In Gmail ist die maximale Anzahl der Empfänger in den kombinierten Feldern
To
undCC
auf 20 eingeschränkt. - Bei Nachrichten, in denen der Empfänger nicht in den Feldern
To
oderCC
enthalten ist, sollten keine Reaktionen möglich sein. - Bei Nachrichten, die bereits viele Reaktionen haben, sollten keine weiteren Reaktionen möglich sein. (In Gmail ist für eine Nachricht eine Obergrenze von 20 Reaktionen pro Nutzer festgelegt.)
Diese und andere Einschränkungen werden auch im Abschnitt „Emoji-Reaktionen können nicht gesendet werden“ des Hilfeartikels Mit Emoji-Reaktionen auf E-Mails antworten beschrieben.