Ada dua cara untuk mengirim email menggunakan Gmail API:
- Anda dapat mengirimkannya langsung menggunakan
metode
messages.send
. - Anda dapat mengirimnya dari draf, menggunakan
metode
drafts.send
.
Email dikirim sebagai string berenkode base64url dalam properti raw
dari
resource pesan. Alur kerja tingkat tinggi untuk mengirim email adalah:
- Buat konten email dengan cara yang mudah dan enkode sebagai string base64url.
- Buat resource pesan baru dan tetapkan properti
raw
-nya ke string base64url yang baru saja Anda buat. - Panggil
messages.send
, atau, jika mengirim draf,drafts.send
untuk mengirim pesan.
Detail alur kerja ini dapat bervariasi bergantung pada pilihan library klien dan bahasa pemrograman Anda.
Membuat pesan
Gmail API memerlukan pesan email MIME yang mematuhi RFC 2822 dan dienkode sebagai string base64url. Banyak bahasa pemrograman memiliki library atau utilitas yang menyederhanakan proses pembuatan dan encoding pesan MIME. Contoh kode berikut menunjukkan cara membuat pesan MIME menggunakan library klien Google API untuk berbagai bahasa.
Membuat pesan email dapat sangat disederhanakan dengan class MimeMessage
dalam paket javax.mail.internet
. Contoh berikut menunjukkan cara
membuat pesan email, termasuk header:
Langkah berikutnya adalah mengenkode MimeMessage
, membuat instance objek Message
, dan menetapkan string pesan yang dienkode base64url sebagai nilai properti raw
.
Contoh kode berikut menunjukkan pembuatan pesan MIME, encoding ke
string base64url, dan menetapkannya ke kolom raw
dari resource
Message
:
Membuat pesan dengan lampiran
Membuat pesan dengan lampiran sama seperti membuat pesan lainnya, tetapi proses mengupload file sebagai pesan MIME multi-bagian bergantung pada bahasa pemrograman. Contoh kode berikut menunjukkan kemungkinan cara membuat pesan MIME multi-bagian dengan lampiran.
Contoh berikut menunjukkan cara membuat pesan MIME multi-bagian, langkah encoding dan penetapan sama seperti di atas.
Serupa dengan contoh sebelumnya, contoh ini juga menangani encoding
pesan ke base64url dan menetapkannya ke kolom raw
dari resource
Message
.
Mengirim pesan
Setelah membuat pesan, Anda dapat mengirimkannya dengan memasukkannya dalam
isi permintaan panggilan ke
messages.send
, seperti yang ditunjukkan
dalam contoh berikut.
Jika Anda mencoba mengirim balasan dan ingin email tersebut menjadi rangkaian pesan, pastikan:
- Header
Subject
cocok - Header
References
danIn-Reply-To
mengikuti standar RFC 2822.
Untuk informasi tentang cara mengirim pesan dari draf, lihat Membuat Draf.