Class GmailDraft

GmailDraft

Draf pesan yang dibuat pengguna di akun Gmail pengguna.

Metode

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

Dokumentasi mendetail

deleteDraft()

Menghapus draf pesan 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 merepresentasikan 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 merepresentasikan 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) dibatasi kuota.

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) dibatasi kuota.

// 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

NamaJenisDeskripsi
recipientStringdaftar alamat email yang dipisahkan koma
subjectStringsubjek email (maksimal 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 draf pesan ini menggunakan argumen opsional. Email dapat berisi teks biasa atau isi HTML. Ukuran email (termasuk header) dibatasi kuota.

// 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

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

Parameter lanjutan

NamaJenisDeskripsi
attachmentsBlobSource[]array file untuk dikirim dengan email
bccStringdaftar alamat email yang dipisahkan koma ke BCC
ccStringdaftar alamat email yang dipisahkan koma ke CC
fromStringalamat asal pengiriman email, yang harus berupa salah satu nilai yang ditampilkan oleh GmailApp.getAliases()
htmlBodyStringjika disetel, perangkat yang mampu merender HTML akan menggunakannya, bukan argumen isi yang diperlukan; Anda dapat menambahkan kolom inlineImages opsional dalam 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