Ada dua cara untuk mengirim email menggunakan Gmail API:
- Anda dapat mengirimkannya langsung menggunakan
Metode
messages.send
. - Anda dapat mengirimkannya dari draf, menggunakan
Metode
drafts.send
.
Email dikirim sebagai string berenkode base64url dalam properti raw
resource pesan. Tingkat tinggi
alur kerja untuk mengirim email adalah untuk:
- Buat konten email dengan cara yang mudah dan enkode sebagai string base64url.
- Buat resource pesan baru dan tetapkan properti
raw
-nya ke base64url {i>string<i} 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 klien Anda {i>library<i} dan bahasa pemrograman.
Membuat pesan
Gmail API memerlukan pesan email MIME yang sesuai dengan RFC 2822 dan yang dienkode sebagai string base64url. Banyak bahasa pemrograman memiliki library atau utilitas yang menyederhanakan proses pembuatan dan encoding MIME membuat pesan teks. Contoh kode berikut menunjukkan cara membuat pesan MIME menggunakan library klien Google API untuk berbagai bahasa.
Java
Membuat pesan email dapat sangat disederhanakan dengan MimeMessage
di paket javax.mail.internet
. Contoh berikut menunjukkan bagaimana
untuk membuat pesan email, termasuk headernya:
Langkah berikutnya adalah mengenkode MimeMessage
, membuat instance Message
dan atur string pesan berenkode base64url sebagai nilai
raw
.
Python
Contoh kode berikut menunjukkan pembuatan pesan MIME, yang mengenkode ke
string base64url, dan menetapkannya ke kolom raw
dari Message
referensi:
Membuat pesan dengan lampiran
Membuat pesan dengan lampiran sama seperti membuat pesan lainnya, tetapi proses mengunggah file sebagai MIME multi-bagian tergantung pada bahasa pemrograman. Kode berikut contoh ini menunjukkan cara yang memungkinkan untuk membuat pesan MIME multi-bagian dengan lampiran.
Java
Contoh berikut memperlihatkan cara membuat pesan MIME multi-bagian, langkah penyandian dan penetapannya sama seperti di atas.
Python
Serupa dengan contoh sebelumnya, contoh ini juga menangani pengkodean
pesan ke base64url dan menetapkannya ke kolom raw
dari Message
resource Anda
Mengirim pesan
Setelah membuat pesan, Anda dapat mengirimkannya dengan menyediakannya di
isi permintaan panggilan ke
messages.send
, seperti yang ditunjukkan
dalam contoh berikut.
Java
Python
Jika Anda mencoba mengirim balasan dan ingin email tersebut di rangkaian pesan, pastikan:
- Header
Subject
cocok - Header
References
danIn-Reply-To
mengikuti RFC 2822.
Untuk informasi tentang cara mengirim pesan dari draf, lihat Membuat Draf.