Reakcje na e-maile

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

Format

Reakcja na e-maila to zwykły e-mail w formacie MIME ze specjalną częścią, która wskazuje, że jest to reakcja.

Ogólny format wiadomości

E-mail musi zawierać część treści z elementem Content-Type: text/vnd.google.email-reaction+json sformatowanym 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 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 e-mail, którzy nie obsługują reakcji na e-maile, nadal widzieli 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órzy klienci poczty e-mail zawsze wyświetlają ostatnią część, niezależnie od tego, czy rozumieją jej typ MIME. Podobnie niektóre klienty poczty e-mail 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. Zawiera 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 Unicode Technical Standard 51.

Jeśli Content-Transfer-Encoding ma format binarny, 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 jej część dotyczącą reakcji i stosuje do niej specjalny sposób wyświetlania.

Weryfikacja

Gmail weryfikuje wszystkie otrzymywane wiadomości z częścią text/vnd.google.email-reaction+json. Jeśli część jest nieprawidłowo sformatowana, 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 uzna część za nieprawidłową.

  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ę rozwoju formatu mogą być akceptowane inne wersje. Jeśli wersja jest nieznana lub jej brakuje, Gmail uzna część za nieprawidłową.

  3. Gmail sprawdza pole emotikonu. Treść musi być dokładnie jednym z emotikonów określonych w wersji 15 lub nowszej standardu technicznego Unicode 51, w tym z wszelkimi powiązanymi rozszerzeniami, takimi 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 wymaganego do wdrożenia nowo opublikowanego standardu. Jeśli pole jest puste, nie zawiera żadnych danych lub nie zawiera dokładnie jednego emoji, Gmail uzna tę część za nieprawidłową.

Wyświetlacz

W przypadku wiadomości z prawidłowymi częściami reakcji e-mailowej Gmail wyświetla emotikon w polu emotikonu obok wiadomości określonej przez nagłówek In-Reply-To. Może to również obejmować liczbę reakcji otrzymanych za pomocą tego emotikona, nadawcę reakcji i inne elementy interfejsu. Jeśli brakuje nagłówka In-Reply-To lub w wątku rozmowy nie można znaleźć wiadomości o podanym identyfikatorze, Gmail wyświetli wiadomość z reakcją jako zwykły e-mail. Pamiętaj, że Gmail może nie znaleźć wiadomości, ponieważ została ona usunięta przez użytkownika, wątek jest zbyt długi lub z innych powodów.

Gdy Gmail wyświetla nieprawidłowe wiadomości z reakcjami na e-maile, wyświetla część text/html, jeśli istnieje. W przeciwnym razie używa części text/plain. Jeśli nie ma żadnej części wiadomości z tymi typami, Gmail wyświetli pustą wiadomość.

Limity

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

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

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