Class GmailDraft

Draf Gmail

Pesan draf yang dibuat pengguna di akun Gmail pengguna.

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
deleteDraft()voidMenghapus pesan draf ini.
getId()StringMendapatkan ID pesan draf ini.
getMessage()GmailMessageMenampilkan GmailMessage yang mewakili draf ini.
getMessageId()StringMenampilkan ID GmailMessage yang mewakili draf ini.
send()GmailMessageMengirim draf pesan email ini.
update(recipient, subject, body)GmailDraftMengganti konten pesan draf ini.
update(recipient, subject, body, options)GmailDraftMengganti konten pesan draf ini menggunakan argumen opsional.

Dokumentasi mendetail

deleteDraft()

Menghapus pesan draf ini.

var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder
draft.deleteDraft();
draft.getMessage(); // Throws exception.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut atau cakupan yang sesuai dari REST API terkait:

  • https://mail.google.com/

getId()

Mendapatkan ID pesan draf ini.

var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder
var draftId = draft.getId();
var draftById = GmailApp.getDraft(draftId);
Logger.log(draft.getMessage().getSubject() == draftById.getMessage().getSubject());

Return

String — ID draf

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut atau cakupan yang sesuai dari REST API terkait:

  • https://mail.google.com/

getMessage()

Menampilkan GmailMessage yang mewakili draf ini.

var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder
var message = draft.getMessage();
Logger.log(message.getSubject());

Return

GmailMessage — pesan yang mewakili konten draf ini

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut atau cakupan yang sesuai dari REST API terkait:

  • https://mail.google.com/

getMessageId()

Menampilkan ID GmailMessage yang mewakili draf ini.

var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder
var messageId = draft.getMessageId();
Logger.log(messageId == draft.getMessage().getId());

Return

String — ID pesan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut atau cakupan yang sesuai dari REST API terkait:

  • https://mail.google.com/

send()

Mengirim draf pesan email ini. Ukuran email (termasuk header) adalah kuota terbatas.

var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder
var msg = draft.send(); // Send it
Logger.log(msg.getDate()); // Should be approximately the current timestamp

Return

GmailMessage — pesan yang baru dikirim

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut atau cakupan yang sesuai dari REST API terkait:

  • https://mail.google.com/

update(recipient, subject, body)

Mengganti konten pesan draf ini. Ukuran email (termasuk header) adalah kuota terbatas.

// The code below will update a draft email with the current date and time.
var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder
var now = new Date();
draft.update("mike@example.com", "current time", "The time is: " + now.toString());

Parameter

NameJenisDeskripsi
recipientStringdaftar alamat email yang dipisahkan koma
subjectStringsubjek email (maksimum 250 karakter)
bodyStringisi email

Return

GmailDraft — draf yang baru diperbarui

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut atau cakupan yang sesuai dari REST API terkait:

  • https://mail.google.com/

Lihat juga


update(recipient, subject, body, options)

Mengganti konten pesan draf ini menggunakan argumen opsional. Email dapat berisi teks biasa atau isi HTML. Ukuran email (termasuk header) adalah kuota terbatas.

// Update a draft email with a file from Google Drive attached as a PDF.
var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder
var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
draft.update('mike@example.com', 'Attachment example', 'Please see attached file.', {
    attachments: [file.getAs(MimeType.PDF)],
    name: 'Automatic Emailer Script'
});

Parameter

NameJenisDeskripsi
recipientStringdaftar alamat email yang dipisahkan koma
subjectStringsubjek email (maksimum 250 karakter)
bodyStringisi email
optionsObjectobjek JavaScript yang menentukan parameter lanjutan, seperti yang tercantum di bawah ini

Parameter lanjutan

NameJenisDeskripsi
attachmentsBlobSource[]array file yang akan dikirim dengan email
bccStringdaftar alamat email yang dipisahkan koma ke BCC
ccStringdaftar alamat email yang dipisahkan koma untuk CC
fromStringalamat pengirim email, yang harus merupakan salah satu nilai yang ditampilkan oleh GmailApp.getAliases()
htmlBodyStringjika ditetapkan, perangkat yang mampu merender HTML akan menggunakannya sebagai ganti argumen isi yang diperlukan; Anda dapat menambahkan kolom inlineImages opsional di isi HTML jika Anda memiliki gambar inline untuk email
inlineImagesObjectobjek JavaScript yang berisi pemetaan dari kunci gambar (String) ke data gambar (BlobSource); ini mengasumsikan bahwa parameter htmlBody digunakan dan berisi referensi ke gambar ini dalam format <img src="cid:imageKey" />
nameStringnama pengirim email (default: nama pengguna)
replyToStringalamat email yang akan digunakan sebagai alamat balas-ke default (default: alamat email pengguna)

Return

GmailDraft — draf yang baru diperbarui

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut atau cakupan yang sesuai dari REST API terkait:

  • https://mail.google.com/

Lihat juga