Dokumen ini menjelaskan cara membuat, memperbarui, dan mengirim email draf menggunakan Gmail API.
Draf email menampilkan pesan yang belum terkirim dengan label sistem DRAFT diterapkan.
Pesan yang ada dalam draf tidak dapat diedit setelah dibuat, tetapi dapat diganti. Dalam hal ini, resource
drafts adalah
penampung yang menyediakan ID stabil karena ID pesan pokok berubah
setiap kali pesan diganti.
Resource messages
di dalam draf memiliki perilaku yang serupa dengan pesan lain, kecuali untuk
perbedaan berikut:
- Pesan draf tidak boleh memiliki label selain label sistem
DRAFT. - Saat draf dikirim, draf akan otomatis dihapus dan pesan baru
dengan ID yang diperbarui akan dibuat dengan label sistem
SENT. Pesan ini ditampilkan dalam respons metodedrafts.send.
Membuat draf
Aplikasi Anda dapat membuat draf menggunakan metode
drafts.create. Untuk membuat draf:
- Buat pesan MIME yang mematuhi RFC 2822.
- Konversi pesan ke string berenkode base64URL.
- Panggil metode
drafts.create, tetapkan nilai kolommessages.rawke string yang dienkode.
Contoh kode berikut menunjukkan prosesnya:
Java
Python
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.
Perbarui draf
Mirip dengan membuat draf, untuk memperbarui draf, Anda harus menyediakan resource drafts
dalam isi permintaan dengan kolom messages.raw yang ditetapkan ke string berenkode
base64URL yang berisi pesan MIME. Karena pesan tidak dapat diperbarui, pesan yang ada dalam draf akan dihapus dan diganti dengan pesan MIME baru yang diberikan dalam permintaan pembaruan.
Anda dapat mengambil pesan MIME saat ini yang ada dalam draf dengan memanggil metode
drafts.get
dengan parameter kueri format=raw.
Untuk mengetahui informasi selengkapnya, lihat metode
drafts.update.
Mengirim draf
Saat mengirim draf, Anda dapat mengirimkannya apa adanya, atau Anda dapat memberikan pembaruan dalam permintaan pengiriman.
Untuk memperbarui draf saat mengirim, berikan resource drafts dalam isi permintaan
metode drafts.send. Di resource drafts, Anda harus menentukan draf
id dari
draf yang akan dikirim dan menetapkan kolom messages.raw ke pesan MIME baru
yang dienkode sebagai string base64URL.
Untuk mengetahui informasi tentang cara mengirim pesan Gmail, lihat Mengirim pesan.