Class GmailDraft

DrafGmail

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 pesan email draf 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. 

const 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. 

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

Pulang pergi

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. 

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

Pulang pergi

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. 

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

Pulang pergi

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 pesan email draf ini. Ukuran email (termasuk header) dibatasi kuota. 

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

Pulang pergi

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.
const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
const 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 (maksimum 250 karakter)
bodyStringisi email

Pulang pergi

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

// Update a draft email with a file from Google Drive attached as a PDF.
const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
const 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 (maksimum 250 karakter)
bodyStringisi email
optionsObjectobjek JavaScript yang menentukan parameter lanjutan, seperti yang tercantum di bawah

Parameter lanjutan

NamaJenisDeskripsi
attachmentsBlobSource[]array file yang akan dikirim dengan email
bccStringdaftar alamat email yang dipisahkan koma untuk BCC
ccStringdaftar alamat email yang dipisahkan koma untuk disertakan dalam kolom Cc
fromStringalamat tempat email harus dikirim, yang harus berupa salah satu nilai yang ditampilkan oleh GmailApp.getAliases()
htmlBodyStringjika ditetapkan, perangkat yang dapat merender HTML akan menggunakannya sebagai pengganti argumen isi yang diperlukan; Anda dapat menambahkan kolom inlineImages opsional di isi HTML jika telah menyisipkan gambar untuk email
inlineImagesObjectobjek JavaScript yang berisi pemetaan dari kunci gambar (String) ke data gambar (BlobSource); hal 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)

Pulang pergi

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