Przykłady reakcji na e-maila

Oto kilka przykładów prawidłowych i nieprawidłowych wiadomości z reakcjami e-mail.

Obowiązuje multipart/alternative

Reakcje na e-maile składają się zwykle z 3 części:

• text/plain: wersja wiadomości w postaci zwykłego tekstu.
• text/vnd.google.email-reaction+json: część reakcji.
• text/html: wersja HTML wiadomości.

Oto przykład:

From: [e-mail]
Message-ID: <[e-mail]>
Subject: subject
MIME-Version: 1.0
In-Reply-To: <[e-mail]>
Content-Type: multipart/alternative;
        boundary="----=_Part_0_2012232625.1697791227635"

------=_Part_0_2012232625.1697791227635
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit

Text body content
------=_Part_0_2012232625.1697791227635
Content-Type: text/vnd.google.email-reaction+json; charset=UTF-8
Content-Transfer-Encoding: quoted-printable

{"emoji":"=F0=9F=99=83","version":1}
------=_Part_0_2012232625.1697791227635
Content-Type: text/html; charset=UTF-8
Content-Transfer-Encoding: quoted-printable

<h1>HTML body content</h1>
------=_Part_0_2012232625.1697791227635--

pojedyncza prawidłowa część ciała,

Reakcje na e-maile mogą też mieć tylko jedną część ciała, np.:

From: [e-mail]
Message-ID: <[e-mail]>
Subject: subject
MIME-Version: 1.0
In-Reply-To: <[e-mail]>
Content-Type: text/vnd.google.email-reaction+json; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

{"emoji":"=F0=9F=99=83","version":1}

Pamiętaj, że Content-Transfer-Encoding może być dowolnym standardowym kodowaniem:

From: [e-mail]
Message-ID: <[e-mail]>
Subject: subject
MIME-Version: 1.0
In-Reply-To: <[e-mail]>
Content-Type: text/vnd.google.email-reaction+json
Content-Transfer-Encoding: base64

ewogICJlbW9qaSI6ICLwn46JIiwKICAidmVyc2lvbiI6IDEKfQ==

W przypadku kodowania binarnego, np. base64, plik JSON musi być zakodowany w formacie UTF-8.

Prawidłowo zagnieżdżone multipart/alternative w multipart/related

Jeśli reakcja dotyczy wiadomości zawierającej załączniki w tekście, możesz wygenerować wiadomość z częścią multipart/related, która zawiera załączniki, oraz częścią multipart/alternative, tak jak w poprzednim przykładzie.

From: [e-mail]
Message-ID: <[e-mail]>
Subject: subject
MIME-Version: 1.0
In-Reply-To: <[e-mail]>
Content-Type: multipart/related;
        boundary="----=_Part_0_2012232625.1697793303618"

------=_Part_0_2012232625.1697793303618
Content-Type: multipart/alternative;
        boundary="----=_Part_1_984213526.1697793303621"

------=_Part_1_984213526.1697793303621
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit

Text body content
------=_Part_1_984213526.1697793303621
Content-Type: text/vnd.google.email-reaction+json
Content-Transfer-Encoding: base64

ewogICJlbW9qaSI6ICLwn46JIiwKICAidmVyc2lvbiI6IDEKfQ==
------=_Part_1_984213526.1697793303621
Content-Type: text/html; charset=UTF-8
Content-Transfer-Encoding: quoted-printable

<h1>HTML body content</h1>
------=_Part_1_984213526.1697793303621--

------=_Part_0_2012232625.1697793303618
Content-Type: image/png
Content-Transfer-Encoding: base64
Content-Disposition: attachment; filename="1x1.png"

iVBORw0KGgoAAAANSUhEUgAAAAEAAAABAQMAAAAl21bKAAAAA1BMVEUAAACnej3aAAAAAXRSTlMA
QObYZgAAAApJREFUCNdjYAAAAAIAAeIhvDMAAAAASUVORK5CYII=
------=_Part_0_2012232625.1697793303618--

(Zwróć uwagę, że element multipart/related powinien mieć inne pola zgodnie ze standardem RFC2387, ale nie mają one znaczenia dla określania, czy reakcja na e-maila jest prawidłowa).

Nieprawidłowy format w usłudze JSON

Ta reakcja jest nieprawidłowa, ponieważ w kodzie JSON brakuje klamry zamykającej:

From: [e-mail]
Message-ID: <[e-mail]>
Subject: subject
MIME-Version: 1.0
In-Reply-To: <[e-mail]>
Content-Type: text/vnd.google.email-reaction+json; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

{"emoji":"=F0=9F=99=83","version":1

Ta reakcja jest nieprawidłowa, ponieważ kod JSON zawiera przecinek na końcu:

From: [e-mail]
Message-ID: <[e-mail]>
Subject: subject
MIME-Version: 1.0
In-Reply-To: <[e-mail]>
Content-Type: text/vnd.google.email-reaction+json; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

{"emoji":"=F0=9F=99=83","version":1,}

Nieprawidłowe pole version

Ta reakcja jest nieprawidłowa, ponieważ brakuje w niej pola version:

From: [e-mail]
Message-ID: <[e-mail]>
Subject: subject
MIME-Version: 1.0
In-Reply-To: <[e-mail]>
Content-Type: text/vnd.google.email-reaction+json; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

{"emoji":"=F0=9F=99=83"}

Ta reakcja jest nieprawidłowa, ponieważ pole version nie jest 1:

From: [e-mail]
Message-ID: <[e-mail]>
Subject: subject
MIME-Version: 1.0
In-Reply-To: <[e-mail]>
Content-Type: text/vnd.google.email-reaction+json; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

{"emoji":"=F0=9F=99=83","version":2}

Nieprawidłowe pole emoji

Ta reakcja jest nieprawidłowa, ponieważ pole emoji jest puste:

From: [e-mail]
Message-ID: <[e-mail]>
Subject: subject
MIME-Version: 1.0
In-Reply-To: <[e-mail]>
Content-Type: text/vnd.google.email-reaction+json; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

{"emoji":"","version":1}

Ta reakcja jest nieprawidłowa, ponieważ pole emoji nie zawiera prawidłowego emotikona.

From: [e-mail]
Message-ID: <[e-mail]>
Subject: subject
MIME-Version: 1.0
In-Reply-To: <[e-mail]>
Content-Type: text/vnd.google.email-reaction+json; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

{"emoji":"A","version":1}

Ta reakcja jest nieprawidłowa, ponieważ między 2 znakami łączącymi o zerowej szerokości (ZWJ) brakuje emotikona ❤. Pamiętaj, że znak = na końcu pierwszego wiersza treści oznacza miękki podział wiersza w kodowaniu Quoted-Printable.

From: [e-mail]
Message-ID: <[e-mail]>
Subject: subject
MIME-Version: 1.0
In-Reply-To: <[e-mail]>
Content-Type: text/vnd.google.email-reaction+json; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

{"emoji":"=F0=9F=91=A9=F0=9F=8F=BC=E2=80=8D=E2=80=8D=F0=9F=91=A8=F0=9F=8F=BE",=
"version":1}