Dokumen ini menjelaskan cara membuat dan mengirim pesan email menggunakan Gmail API.
Ada dua cara untuk mengirim email menggunakan Gmail API:
- Anda dapat mengirimkannya secara langsung menggunakan metode
messages.send. - Anda dapat mengirimkannya dari draf, menggunakan metode
drafts.send. Untuk mengetahui informasi selengkapnya tentang cara mengirim pesan draf, lihat Mengirim draf.
Pesan Gmail dikirim sebagai string berenkode base64URL dalam kolom
raw
resource messages. Untuk mengirim pesan email:
- Buat konten email dan encode sebagai string base64URL.
- Buat resource pesan baru dan tetapkan properti
raw-nya ke string base64URL yang baru saja Anda buat. - Panggil metode
messages.send, atau, jika mengirim draf, panggil metodedrafts.senduntuk 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 sesuai dengan 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:
Java
Pembuatan pesan email dapat disederhanakan dengan class MimeMessage di
paket javax.mail.internet. Contoh kode berikut menunjukkan cara membuat pesan email, termasuk header:
Selanjutnya, lakukan enkode MimeMessage, buat objek messages, dan tetapkan string pesan yang dienkode base64URL sebagai nilai properti raw.
Python
Contoh kode berikut menunjukkan cara membuat pesan MIME, mengenkodekannya ke string base64URL, dan menetapkannya ke kolom raw dari resource messages:
cURL
curl --request POST \
'https://gmail.googleapis.com/gmail/v1/users/me/drafts' \
--header 'Authorization: Bearer ACCESS_TOKEN' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{"message":{"raw":"MESSAGE"}}'
Ganti kode berikut:
ACCESS_TOKEN: token akses yang memberikan akses ke API.MESSAGE: pesan MIME berformat RFC 2822, dienkode sebagai base64URL.
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:
Java
Contoh kode berikut menunjukkan cara membuat pesan MIME multi-bagian. Langkah-langkah encoding dan penetapan sama dengan membuat pesan.
Python
Mirip dengan contoh membuat pesan, contoh ini
juga menangani encoding pesan ke base64URL dan menetapkannya ke kolom raw
pada resource messages.
cURL
curl --request POST \
'https://gmail.googleapis.com/gmail/v1/users/me/drafts' \
--header 'Authorization: Bearer ACCESS_TOKEN' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{"message":{"raw":"MESSAGE"}}'
Ganti kode berikut:
ACCESS_TOKEN: token akses yang memberikan akses ke API.MESSAGE: pesan MIME berformat RFC 2822 yang berisi lampiran, dienkode sebagai base64URL.
Mengirim pesan
Setelah membuat pesan, Anda dapat mengirimkannya dengan menyediakannya di isi permintaan
metode
messages.send, seperti yang ditunjukkan dalam contoh berikut:
Java
Python
cURL
curl --request POST \
'https://gmail.googleapis.com/gmail/v1/users/me/messages/send' \
--header 'Authorization: Bearer ACCESS_TOKEN' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{"raw":"MESSAGE"}'
Ganti kode berikut:
ACCESS_TOKEN: token akses yang memberikan akses ke API.MESSAGE: pesan MIME berformat RFC 2822, dienkode sebagai base64URL.
Jika Anda mencoba mengirim balasan dan ingin email dikelompokkan ke dalam rangkaian pesan, pastikan bahwa:
- Header
Subjectcocok - Header
ReferencesdanIn-Reply-Tomengikuti standar RFC 2822.