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ęść treści z Content-Type: text/vnd.google.email-reaction+json, sformatowaną zgodnie z opisem w definicji.

Część treści 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. Wynika to z tego, że 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 emotikona 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.

Walidacja

Gmail sprawdza wszystkie otrzymane 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 JSON i sprawdza jego poprawność. Jeśli JSON jest nieprawidłowo sformatowany, Gmail uznaje tę część za nieprawidłową.

  2. Gmail sprawdza pole version. Wersja musi być 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 emotikonem określonym w wersji 15 lub nowszej specyfikacji Unicode Technical Standard 51, w tym w przypadku wszelkich powiązanych rozszerzeń, takich jak odcień skóry. W miarę rozwoju standardu emotikonów Gmail zobowiązuje się do obsługi co najmniej najnowszej wersji minus

    1. Gmail prawdopodobnie obsługuje najnowszą wersję, z wyjątkiem okresu wymaganego do wdrożenia nowo opublikowanego standardu. Jeśli pole jest puste, brakuje go lub nie zawiera dokładnie 1 emotikona, 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 emotikon w polu emoji obok wiadomości określonej w nagłówku In-Reply-To. Może to też obejmować liczbę reakcji otrzymanych z tym emotikonem, nadawcę tej reakcji lub 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. Gmail może nie znaleźć wiadomości, jeśli użytkownik ją usunął, wątek jest 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 treści z żadnym z tych typów, Gmail wyświetla pustą wiadomość.

Limity

Gmail zaleca, aby klienci, którzy chcą obsługiwać reakcje na e-maile, stosowali limity, aby zapobiec przytłaczaniu użytkowników reakcjami. W szczególności:

  • Wiadomości z list adresowych nie powinny obsługiwać reakcji.
  • Wiadomości z zbyt dużą liczbą odbiorców nie powinny obsługiwać reakcji (np. więcej niż 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 obsługiwać reakcji.
  • Wiadomości, które mają już wiele reakcji, nie powinny obsługiwać reakcji (np. więcej niż 20 reakcji na użytkownika w przypadku pojedynczej wiadomości).

Te i inne limity są też opisane w sekcji „Brak możliwości wysyłania emotikonów ” w artykule Odpowiadanie na e-maile za pomocą emotikonów.