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 na e-maila to zwykły e-mail w formacie MIME ze specjalną częścią wskazującą, że jest to reakcja.

Ogólny format wiadomości

E-mail musi mieć część body z Content-Type: text/vnd.google.email-reaction+json sformatowaną zgodnie z opisem w definicji.

Część body to:

  • część wiadomości najwyższego poziomu. Oznacza to, że nagłówek Content-Type e-maila to text/vnd.google.email-reaction+json.
  • podczęść części MIME typu multipart, która ma Content-Type o wartości text/vnd.google.email-reaction+json i Content-Disposition o wartości innej niż attachment.

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

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

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

Ta część MIME jest w formacie JSON. Ma 2 pola:

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

Jeśli Content-Transfer-Encoding jest formatem 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 w Gmailu

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

Weryfikacja

Gmail weryfikuje wszystkie otrzymane wiadomości z częścią text/vnd.google.email-reaction+json. Jeśli część jest nieprawidłowa, jest uznawana za nieprawidłową, a wiadomość nie jest traktowana jako reakcja.

W szczególności:

  1. Gmail analizuje kod JSON i sprawdza jego poprawność. Jeśli kod JSON jest nieprawidłowy, Gmail uznaje tę część za nieprawidłową.

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

  3. Gmail sprawdza pole emoji. Zawartość musi być dokładnie 1 z emoji określonych w wersji 15 lub nowszej specyfikacji Unicode Technical Standard 51 w tym wszelkich powiązanych rozszerzeń, takich jak odcień skóry. W miarę rozwoju standardu emoji Gmail zobowiązuje się do obsługi co najmniej najnowszej wersji – 1. Gmail prawdopodobnie obsługuje najnowszą wersję, z wyjątkiem okresu potrzebnego na wdrożenie nowo opublikowanego standardu. Jeśli pole jest puste, brakuje go lub nie zawiera dokładnie 1 emoji, Gmail uznaje tę część za nieprawidłową.

Wyświetlanie

W przypadku wiadomości z prawidłowymi częściami reakcji na e-maila Gmail wyświetla emoji w polu emoji obok wiadomości określonej w nagłówku In-Reply-To. Może to też obejmować liczbę reakcji otrzymanych z tym emoji, nadawcę tej reakcji i inne elementy interfejsu. Jeśli brakuje nagłówka In-Reply-To lub nie można znaleźć wiadomości o podanym identyfikatorze w wątku rozmowy, Gmail wyświetla wiadomość z reakcją jako zwykłego e-maila. Pamiętaj, że Gmail może nie być w stanie znaleźć wiadomości, ponieważ użytkownik ją usunął, wątek stał się zbyt długi lub z innych powodów.

Podczas wyświetlania nieprawidłowych wiadomości z reakcjami na e-maile Gmail wyświetla część text/html, jeśli istnieje. W przeciwnym razie używa części text/plain. Jeśli nie ma części body z żadnym z tych typów, Gmail wyświetla pustą wiadomość.

Limity

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

  • Wiadomości z list adresowych nie powinny zezwalać na reakcje.
  • Wiadomości z zbyt dużą liczbą odbiorców nie powinny zezwalać na reakcje. (Gmail używa limitu 20 różnych odbiorców w połączonych To i CC polach.)
  • Wiadomości, w których odbiorca nie znajduje się w polach To ani CC, nie powinny zezwalać na reakcje.
  • Wiadomości, które mają już wiele reakcji, nie powinny zezwalać na reakcje. (Gmail używa limitu 20 reakcji na użytkownika w przypadku każdej wiadomości.)

Te i inne limity są też opisane w sekcji „Nie można wysłać reakcji emotikonem” w artykule Odpowiadanie na e-maile za pomocą emotikonów.