Draf menunjukkan pesan yang tidak terkirim dengan penerapan label sistem DRAFT
.
Pesan yang terdapat dalam draf tidak dapat diedit setelah dibuat, tetapi
dapat diganti. Dalam hal ini,
draf resource hanyalah container
yang menyediakan ID stabil karena ID pesan yang mendasarinya berubah setiap kali
pesan akan diganti.
Referensi pesan di dalam draf memiliki perilaku yang serupa dengan pesan lain, kecuali 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 dibuat dengan label sistem
SENT
. Pesan ini yang ditampilkan didrafts.send
yang dihasilkan.
Daftar Isi
Membuat draf pesan
Aplikasi Anda dapat membuat draf menggunakan drafts.create. Tujuan proses umumnya adalah untuk:
- Buat pesan MIME yang sesuai dengan RFC 2822.
- Konversi pesan menjadi string berenkode base64url.
- Buat draf, dengan menyetel
nilai kolom
drafts.message.raw
ke string yang dienkode.
Contoh kode berikut menunjukkan prosesnya.
Java
Python
Memperbarui draf
Sama halnya dengan membuat draf, untuk memperbarui draf, Anda harus memberikan Draft
resource di isi permintaan Anda dengan kolom draft.message.raw
setel ke string berenkode base64url yang berisi pesan MIME. Karena
pesan tidak dapat diperbarui, pesan yang ada dalam draf telah dihancurkan
dan diganti dengan pesan MIME baru yang disediakan dalam permintaan update.
Anda dapat mengambil pesan MIME saat ini yang dimuat 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 terbaru. Jika Anda memperbarui konten draf dengan pesan baru,
berikan resource Draft
dalam isi
Permintaan drafts.send
; tolong atur
draft.id
draf yang akan dikirim; dan setel kolom draft.message.raw
ke
pesan MIME baru yang dienkode sebagai string berenkode base64url. Untuk selengkapnya
informasi selengkapnya, lihat drafts.send
.