E-Mail-Reaktionen

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‑Mail text/vnd.google.email-reaction+json ist.
  • Ein Unterteil eines mehrteiligen MIME-Teils mit einem Content-Type von text/vnd.google.email-reaction+json und einem Content-Disposition, das nicht attachment ist.

Die E‑Mail mit der Reaktion sollte auch normale text/plain- und text/html-Teile enthalten, 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 den letzten Teil immer 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. Dieser Wert muss 1 sein.
  • 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 für das JSON die UTF‑8-Zeichencodierung verwendet werden. 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

In Gmail werden alle Nachrichten mit einem text/vnd.google.email-reaction+json-Teil validiert. Wenn der Teil fehlerhaft ist, gilt er als ungültig und die Nachricht wird nicht als Reaktion behandelt.

Wichtig ist insbesondere:

  1. Gmail parst das JSON und prüft seine Gültigkeit. Wenn das JSON fehlerhaft ist, gilt der Teil in Gmail als ungültig.

  2. Gmail prüft das Feld version. Die Version muss genau 1 sein. Es muss eine Ganzzahl sein, kein String. 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.

  3. 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 51angegeben sind, einschließlich aller referenzierten Erweiterungen wie z. B. Hautfarbe. Da sich der Emoji-Standard weiterentwickelt, wird in Gmail mindestens die neueste Version minus

    1. 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 in der Nähe der Nachricht angezeigt, die durch den In-Reply-To-Header angegeben wird. Möglicherweise wird auch die Anzahl der Reaktionen mit diesem Emoji angezeigt. Außerdem kann der Absender dieser Reaktion oder andere UI-Elemente angezeigt werden. 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. Gmail findet die Nachricht möglicherweise nicht, wenn der Nutzer sie gelöscht hat, der Thread zu lang 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 E‑Mail-Reaktionen unterstützen möchten, Limits festlegen, um zu verhindern, dass Nutzer von Reaktionen überfordert werden. Wichtig ist insbesondere:

  • Nachrichten von Mailinglisten sollten keine Reaktionen unterstützen.
  • Nachrichten mit zu vielen Empfängern sollten keine Reaktionen unterstützen (z. B. mehr als 20 verschiedene Empfänger in den kombinierten Feldern To und CC).
  • Nachrichten, bei denen der Empfänger nicht in den Feldern To oder CC enthalten ist, sollten keine Reaktionen unterstützen.
  • Nachrichten, die bereits viele Reaktionen haben, sollten keine Reaktionen unterstützen (z. B. mehr als 20 Reaktionen pro Nutzer für eine einzelne 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.