Draf mewakili pesan yang tidak terkirim dengan label sistem DRAFT
diterapkan.
Pesan yang ada dalam draf tidak dapat diedit setelah dibuat, tetapi
dapat diganti. Dalam pengertian ini, resource draf hanyalah penampung yang memberikan ID stabil karena ID pesan yang mendasarinya berubah setiap kali pesan diganti.
Resource pesan 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 tersebut akan otomatis dihapus dan pesan baru dengan ID yang diperbarui akan dibuat dengan label sistem
SENT
. Pesan ini ditampilkan dalam responsdrafts.send
.
Daftar Isi
Membuat draf pesan
Aplikasi Anda dapat membuat draf menggunakan metode drafts.create. Proses umumnya adalah:
- Buat pesan MIME yang mematuhi RFC 2822.
- Konversikan pesan ke string berenkode base64url.
- Buat draf, dengan menetapkan nilai kolom
drafts.message.raw
ke string yang dienkode.
Contoh kode berikut menunjukkan prosesnya.
Java
Python
Memperbarui draf
Sama halnya dengan membuat draf, untuk mengupdate draf, Anda harus menyediakan resource Draft
dalam isi permintaan dengan kolom draft.message.raw
yang ditetapkan ke string berenkode base64url yang berisi pesan MIME. Karena pesan tidak dapat diperbarui, pesan yang ada dalam draf akan dihancurkan dan diganti dengan pesan MIME baru yang disediakan dalam permintaan update.
Anda dapat mengambil pesan MIME saat ini yang ada di dalam draf dengan memanggil drafts.get
dengan parameter format=raw
.
Untuk mengetahui informasi selengkapnya, lihat
drafts.update
.
Mengirim draf
Saat mengirim draf, Anda dapat memilih untuk mengirim pesan apa adanya atau dengan pesan yang diperbarui. Jika Anda memperbarui konten draf dengan pesan baru,
berikan resource Draft
dalam isi
permintaan drafts.send
; tetapkan
draft.id
draf yang akan dikirim; dan tetapkan kolom draft.message.raw
ke
pesan MIME baru yang dienkode sebagai string berenkode base64url. Untuk mengetahui
informasi selengkapnya, lihat drafts.send
.