Przykłady reakcji na e-maila

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

Obowiązuje multipart/alternative

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

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

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ż dotyczyć tylko jednej części 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, kod JSON musi być zakodowany w formacie UTF-8.

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

Jeśli reakcja dotyczy wiadomości z załącznikami w tekście, można wygenerować wiadomość z multipart/related częścią treści zawierającą załączniki oraz multipart/alternative częścią podobną do poprzedniego przykładu.

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--

(Pamiętaj, że część treści multipart/related powinna zawierać inne pola zgodnie z RFC2387, ale nie mają one znaczenia dla określenia, czy reakcja na e-maila jest prawidłowa).

Nieprawidłowy format w usłudze JSON

Poniższa reakcja jest nieprawidłowa, ponieważ w pliku JSON brakuje nawiasu zamykającego:

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

Poniższa reakcja jest nieprawidłowa, ponieważ w kodzie JSON znajduje się 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 ma wartości 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 dwoma znakami łączącymi o zerowej szerokości (ZWJ) brakuje emotikona ❤. Zwróć uwagę, ż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}