Dengan reaksi email, pengguna dapat merespons pesan email dengan cara yang menyenangkan dan bebas hambatan menggunakan emoji.
Format
Reaksi email adalah email berformat MIME reguler dengan bagian khusus yang menunjukkan bahwa itu merupakan reaksi.
Format pesan secara keseluruhan
Email harus memiliki bagian isi dengan Content-Type:
text/vnd.google.email-reaction+json
yang diformat seperti yang dijelaskan dalam
definisi.
Bagian isi berupa:
- Bagian tingkat atas dari pesan. Artinya, header
Content-Type
dari email ini adalahtext/vnd.google.email-reaction+json
. - Sub-bagian dari bagian MIME multibagian yang memiliki
Content-Type
text/vnd.google.email-reaction+json
danContent-Disposition
yang bukanattachment
.
Email reaksi juga harus memiliki bagian text/plain
dan text/html
reguler
sehingga program email yang tidak mendukung reaksi email tetap menampilkan sesuatu
sebagai respons. Gmail merekomendasikan untuk menempatkan bagian text/vnd.google.email-reaction+json
di antara bagian text/plain
dan text/html
. Hal ini karena beberapa program email selalu menampilkan bagian terakhir, terlepas dari apakah klien tersebut benar-benar memahami jenis MIME-nya atau tidak. Demikian juga, beberapa program email hanya menampilkan bagian pertama.
Email juga harus memiliki header In-Reply-To
yang berisi ID pesan dari pesan yang dikenai reaksi. ID ini harus berupa ID pesan tunggal.
Definisi bagian text/vnd.google.email-reaction+json
Bagian MIME ini menggunakan format JSON. Class ini memiliki dua kolom:
version
: Bilangan bulat yang mewakili versi format reaksi email yang sesuai dengan bagian ini. Kolom ini harus1
.emoji
: String yang merepresentasikan hanya satu simbol emoji seperti yang ditentukan oleh Unicode Technical Standard 51.
Jika Content-Transfer-Encoding
adalah format biner, JSON harus menggunakan encoding karakter UTF-8. Jika tidak, Content-Transfer-Encoding
dapat berupa encoding standar apa pun.
Interpretasi Gmail terhadap text/vnd.google.email-reaction+json
Saat menerima pesan yang terlihat seperti reaksi, Gmail akan memvalidasi bagian reaksi dan menerapkan perlakuan tampilan khusus pada pesan tersebut.
Validasi
Gmail memvalidasi semua pesan dengan bagian text/vnd.google.email-reaction+json
yang diterimanya. Jika formatnya salah, bagian tersebut dianggap tidak valid dan
pesan tidak akan diperlakukan sebagai reaksi.
Khususnya:
Gmail mengurai JSON dan memeriksa validitasnya. Jika format JSON-nya salah, Gmail akan menganggap bagian tersebut tidak valid.
Gmail akan memeriksa kolom versi. Versi harus tepat 1. Harus berupa bilangan bulat; tidak boleh berupa string. Seiring berkembangnya format, versi lain mungkin diterima. Jika versi tidak diketahui atau tidak ada, Gmail akan menganggap bagian tersebut tidak valid.
Gmail akan memeriksa kolom emoji. Konten harus sama persis dengan salah satu emoji yang ditentukan dalam Unicode Technical Standard 51 versi 15 atau yang lebih baru, termasuk ekstensi yang direferensikan, seperti warna kulit. Seiring berkembangnya standar emoji, Gmail berkomitmen untuk mendukung setidaknya versi terbaru - 1. Gmail mungkin mendukung versi terbaru kecuali jendela yang diperlukan untuk menerapkan standar yang baru dirilis. Jika kolom tidak ada, kosong, atau tidak berisi tepat satu emoji, Gmail akan menganggap bagian tersebut tidak valid.
Display
Untuk pesan dengan bagian reaksi email yang valid, Gmail menampilkan emoji di
kolom emoji di dekat pesan yang ditentukan oleh header In-Reply-To
. Data ini mungkin
juga mencakup jumlah reaksi yang diterima dengan emoji tersebut, mungkin menampilkan pengirim reaksi tersebut, dan kemungkinan perlakuan UI lainnya. Jika header In-Reply-To
tidak ada atau pesan dengan ID yang diberikan tidak dapat ditemukan dalam rangkaian percakapan, Gmail akan menampilkan pesan reaksi sebagai email biasa. Perhatikan bahwa Gmail mungkin tidak dapat menemukan pesan tersebut karena
pengguna menghapusnya, rangkaian pesan menjadi terlalu panjang, atau karena sejumlah alasan lain.
Saat menampilkan pesan reaksi email yang tidak valid, Gmail akan menampilkan bagian text/html
jika ada. Jika tidak, bagian text/plain
akan digunakan. Jika tidak ada bagian isi
yang memiliki salah satu bagian tersebut, Gmail akan menampilkan pesan kosong.
Batas
Gmail merekomendasikan agar klien yang ingin menambahkan dukungan untuk reaksi email menambahkan beberapa batasan agar reaksi tidak membebani pengguna. Khususnya:
- Pesan dari milis tidak boleh mengizinkan reaksi.
- Pesan dengan terlalu banyak penerima seharusnya tidak mengizinkan reaksi. (Gmail menggunakan batas 20 penerima berbeda di kolom gabungan
To
danCC
.) - Pesan yang penerimanya tidak berada dalam kolom
To
atauCC
tidak boleh mengizinkan reaksi. - Pesan yang sudah memiliki banyak reaksi seharusnya tidak mengizinkan reaksi. (Gmail menggunakan batas 20 reaksi per pengguna untuk satu pesan.)
Batasan ini dan batasan lainnya juga dijelaskan di bagian "Tidak dapat mengirim reaksi emoji" di Membalas email dengan reaksi emoji.