Reakcje na e-maile

Reakcje na e-maile umożliwiają użytkownikom odpowiadanie na e-maile w zabawny i bezproblemowy sposób za pomocą emotikonów.

Format

Reakcja e-mailowa to zwykły e-mail w formacie MIME ze specjalnym elementem, który wskazuje, że jest to reakcja.

Ogólny format wiadomości

E-mail musi zawierać część ciała z Content-Type: text/vnd.google.email-reaction+json sformatowaną zgodnie z definicją.

Część ciała to:

  • Najwyższy poziom wiadomości. Oznacza to, że nagłówek Content-Type e-maila to text/vnd.google.email-reaction+json.
  • Część podrzędna części MIME złożonej, która ma Content-Type text/vnd.google.email-reaction+json i Content-Disposition, która nie jest attachment.

E-mail z reakcją powinien też zawierać zwykłe sekcje text/plain i text/html, aby klienci poczty e-mail, którzy nie obsługują reakcji, mogli zobaczyć jakąś odpowiedź. Gmail zaleca umieszczenie części text/vnd.google.email-reaction+json między częściami text/plain i text/html. Dzieje się tak, ponieważ niektóre klienty poczty e-mail zawsze wyświetlają ostatnią część niezależnie od tego, czy rozumieją typ MIME. Podobnie niektóre klienty poczty wyświetlają tylko pierwszą część.

E-mail powinien też zawierać nagłówek In-Reply-To z identyfikatorem wiadomości, do której ma zastosowanie reakcja. Musi to być identyfikator pojedynczej wiadomości.

text/vnd.google.email-reaction+json definicja części

Ten element MIME jest w formacie JSON. Zawiera 2 pola:

  • version: liczba całkowita reprezentująca wersję formatu reakcji e-maila, z którym jest zgodna ta część. Musi to być 1.
  • emoji: ciąg znaków reprezentujący dokładnie 1 symbol emotikonu zgodnie z specyfikacją Unicode Technical Standard 51.

Jeśli Content-Transfer-Encoding jest w formacie binarnym, JSON musi używać kodowania znaków UTF-8. W przeciwnym razie Content-Transfer-Encoding może być dowolnym standardowym kodowaniem.

Interpretacja text/vnd.google.email-reaction+json przez Gmaila

Gdy Gmail otrzyma wiadomość, która wygląda jak reakcja, sprawdza część reakcji i stosuje do niej specjalne wyświetlanie.

Weryfikacja

Gmail weryfikuje wszystkie wiadomości z użyciem części text/vnd.google.email-reaction+json, która jest w nich zawarta. Jeśli część jest nieprawidłowa, jest uznawana za nieprawidłową, a wiadomość nie jest traktowana jako reakcja.

W szczególności:

  1. Gmail parsuje dane w formacie JSON i sprawdza ich poprawność. Jeśli kod JSON jest nieprawidłowy, Gmail uzna go za nieprawidłowy.

  2. Gmail sprawdza pole wersji. Wersja musi wynosić dokładnie 1. Musi to być liczba całkowita, a nie ciąg znaków. W miarę ulepszania formatu inne wersje mogą być akceptowane. Jeśli wersja jest nieznana lub jej brakuje, Gmail uzna część za nieprawidłową.

  3. Gmail sprawdza pole emotikonów. Treść musi być dokładnie jednym z emotikonów określonych w wersji 15 lub nowszej standardu technicznego Unicode 51, w tym rozszerzeń, takich jak odcień skóry. Wraz z rozwojem standardu emotikonów Gmail będzie obsługiwał co najmniej najnowszą wersję – 1. Gmail prawdopodobnie obsługuje najnowszą wersję, z wyjątkiem okresu wymaganego do wdrożenia nowo opublikowanego standardu. Jeśli pola nie ma, jest puste lub zawiera więcej niż 1 emoji, Gmail uzna je za nieprawidłowe.

Sieć reklamowa

W przypadku wiadomości z prawidłowymi elementami reakcji Gmail wyświetla emotikon w polu emotikonu obok wiadomości określonej przez nagłówek In-Reply-To. Może to obejmować liczbę reakcji otrzymanych za pomocą tego emotikona, a także wysyłającego tę reakcję oraz potencjalnie inne elementy interfejsu. Jeśli nagłówek In-Reply-To jest nieobecny lub w wątku rozmowy nie można znaleźć wiadomości o podanym identyfikatorze, Gmail wyświetli wiadomość z reakcją jako zwykłego e-maila. Pamiętaj, że Gmail może nie znaleźć wiadomości, ponieważ użytkownik ją usunął, wątek jest zbyt długi lub z innego powodu.

Gdy wyświetla nieprawidłowe reakcje na e-maile, Gmail wyświetla część text/html, jeśli istnieje. W przeciwnym razie używa się części text/plain. Jeśli nie ma żadnych części ciała, Gmail wyświetli pustą wiadomość.

Limity

Gmail zaleca, aby klienci, którzy chcą dodać obsługę reakcji na e-maile, wprowadzili pewne limity, aby reakcje nie przytłoczyły użytkowników. W szczególności:

  • Wiadomości z list mailingowych nie powinny umożliwiać dodawania reakcji.
  • Reakcji nie można dodawać do wiadomości z za dużą liczbą odbiorców. (Gmail stosuje limit 20 osob w połączonych polach To i CC).
  • Wiadomości, w których odbiorca nie znajduje się w polach To lub CC, nie powinny zezwalać na reakcje.
  • Wiadomości, które mają już wiele reakcji, nie powinny umożliwiać dodawania kolejnych. (Gmail stosuje limit 20 reakcji na użytkownika na jedną wiadomość).

Te i inne limity są również opisane w sekcji „Nie można wysłać reakcji emotikonów” w artykule Odpowiedzi na e-maile z reakcjami emotikonów.