Class GmailMessage

PesanGmail

Pesan di akun Gmail pengguna.

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
createDraftReply(body)GmailDraftMembuat draf pesan yang membalas pengirim pesan ini menggunakan alamat balas-ke.
createDraftReply(body, options)GmailDraftMembuat draf pesan yang membalas pengirim pesan ini menggunakan alamat balas-ke, dengan argumen opsional.
createDraftReplyAll(body)GmailDraftMembuat draf pesan yang membalas pengirim menggunakan alamat balas-ke dan semua penerima pesan ini.
createDraftReplyAll(body, options)GmailDraftMembuat draf pesan yang membalas pengirim pesan ini menggunakan alamat balas-ke dan semua penerima, dengan argumen opsional.
forward(recipient)GmailMessageMeneruskan pesan ini ke penerima baru.
forward(recipient, options)GmailMessageMeneruskan pesan ini ke penerima baru, dengan argumen opsional.
getAttachments()GmailAttachment[]Mendapatkan semua lampiran untuk pesan ini.
getAttachments(options)GmailAttachment[]Mendapatkan semua lampiran untuk pesan ini.
getBcc()StringMendapatkan penerima yang dipisahkan koma berdasarkan pesan ini.
getBody()StringMendapatkan konten HTML dari isi pesan ini.
getCc()StringMendapatkan penerima yang dipisahkan koma di CC'd pada pesan ini.
getDate()DateMendapatkan tanggal dan waktu pesan ini.
getFrom()StringMendapatkan pengirim pesan ini.
getHeader(name)StringMendapatkan nilai header RFC 2822 dengan nama header.
getId()StringMendapatkan ID pesan ini.
getPlainBody()StringMendapatkan konten isi pesan ini tanpa format HTML.
getRawContent()StringMendapatkan konten mentah pesan ini.
getReplyTo()StringMendapatkan alamat balas-ke pesan ini (biasanya pengirim).
getSubject()StringMendapatkan subjek pesan ini.
getThread()GmailThreadMendapatkan rangkaian pesan yang berisi pesan ini.
getTo()StringMendapatkan penerima yang dipisahkan koma untuk pesan ini.
isDraft()BooleanMendapatkan apakah pesan ini adalah draf.
isInChats()BooleanMendapatkan apakah pesan ini berupa chat.
isInInbox()BooleanMendapatkan apakah pesan ini ada di kotak masuk.
isInPriorityInbox()BooleanMenampilkan true jika pesan ini berada dalam kotak masuk prioritas; menampilkan false jika tidak.
isInTrash()BooleanMendapatkan apakah pesan ini ada di sampah.
isStarred()BooleanMendapatkan apakah pesan ini berbintang.
isUnread()BooleanMendapatkan apakah pesan ini belum dibaca.
markRead()GmailMessageMenandai pesan sebagai sudah dibaca.
markUnread()GmailMessageMenandai pesan sebagai belum dibaca.
moveToTrash()GmailMessageMemindahkan pesan ke sampah.
refresh()GmailMessageMemuat ulang pesan ini dan status terkait dari Gmail (berguna jika label, status baca, dll., telah berubah).
reply(body)GmailMessageBalasan untuk pengirim pesan ini menggunakan alamat balas-ke.
reply(body, options)GmailMessageBalasan untuk pengirim pesan ini menggunakan alamat balas-ke, dengan argumen opsional.
replyAll(body)GmailMessageAkan membalas pengirim menggunakan alamat balas-ke dan semua penerima pesan ini.
replyAll(body, options)GmailMessageAkan membalas pengirim pesan ini menggunakan alamat balas-ke dan semua penerima, dengan argumen opsional.
star()GmailMessageMemberi bintang pada pesan.
unstar()GmailMessageHapus bintang pada pesan.

Dokumentasi mendetail

createDraftReply(body)

Membuat draf pesan yang membalas pengirim pesan ini menggunakan alamat balas-ke. Ukuran email (termasuk header) adalah kuota terbatas.

// Create a draft reply to the original message with an acknowledgment.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.createDraftReply("Got your message");

Parameter

NameJenisDeskripsi
bodyStringIsi email.

Return

GmailDraft — Pesan draf yang baru dibuat.

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


createDraftReply(body, options)

Membuat draf pesan yang membalas pengirim pesan ini menggunakan alamat balas-ke, dengan argumen opsional.

Email dapat berisi teks biasa dan teks HTML. Ukuran email (termasuk header) adalah kuota terbatas.

// Create a draft response with an HTML text body.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.createDraftReply("incapable of HTML", {
  htmlBody: "<b>some HTML body text</b>",
  cc: "another@example.com"
});

Parameter

NameJenisDeskripsi
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)
subjectStringbaris subjek baru untuk email

Return

GmailDraft — Pesan draf yang baru dibuat.

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


createDraftReplyAll(body)

Membuat draf pesan yang membalas pengirim menggunakan alamat balas-ke dan semua penerima pesan ini. Ukuran email (termasuk header) adalah kuota terbatas.

// Create a draft response to all recipients (except those bcc'd) with an acknowledgment.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.createDraftReplyAll("Got your message");

Parameter

NameJenisDeskripsi
bodyStringIsi email.

Return

GmailDraft — Pesan draf yang baru dibuat.

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


createDraftReplyAll(body, options)

Membuat draf pesan yang membalas pengirim pesan ini menggunakan alamat balas-ke dan semua penerima, dengan argumen opsional.

Email dapat berisi teks biasa dan teks HTML. Ukuran email (termasuk header) adalah kuota terbatas.

// Create a draft response to all recipients (except those bcc'd) using an HTML text body.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.createDraftReplyAll("incapable of HTML", {
  htmlBody: "<b>some HTML body text</b>",
  cc: "another@example.com"
});

Parameter

NameJenisDeskripsi
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)
subjectStringbaris subjek baru untuk email

Return

GmailDraft — Pesan draf yang baru dibuat.

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


forward(recipient)

Meneruskan pesan ini ke penerima baru. Ukuran email (termasuk header) adalah kuota terbatas.

// Forward first message of first inbox thread to recipient1 & recipient2, both @example.com
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.forward("recipient1@example.com,recipient2@example.com");

Parameter

NameJenisDeskripsi
recipientStringDaftar alamat email yang dipisahkan koma.

Return

GmailMessage — Pesan ini, berguna untuk pembuatan rantai.

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


forward(recipient, options)

Meneruskan pesan ini ke penerima baru, dengan argumen opsional.

Email dapat berisi teks biasa dan badan HTML. Ukuran email (termasuk header) adalah kuota terbatas.

var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.forward("recipient1@example.com,recipient2@example.com", {
  cc: "myboss@example.com",
  bcc: "mybosses-boss@example.com,vp@example.com"
});

Parameter

NameJenisDeskripsi
recipientStringDaftar alamat email yang dipisahkan koma.
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)
noReplyBooleantrue jika email harus dikirim dari alamat email no-reply generik untuk mencegah penerima merespons email; opsi ini hanya memungkinkan untuk akun Google Workspace, bukan pengguna Gmail
replyToStringalamat email yang akan digunakan sebagai alamat balas-ke default (default: alamat email pengguna)
subjectStringbaris subjek baru untuk email

Return

GmailMessage — Pesan ini, berguna untuk pembuatan rantai.

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


getAttachments()

Mendapatkan semua lampiran untuk pesan ini.

Return

GmailAttachment[] — Array lampiran Blob untuk pesan 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/

getAttachments(options)

Mendapatkan semua lampiran untuk pesan ini.

Parameter

NameJenisDeskripsi
optionsObjectObjek JavaScript yang menentukan parameter lanjutan, seperti yang tercantum di bawah ini.

Parameter lanjutan

NameJenisDeskripsi
includeInlineImagesBooleantrue jika array lampiran Blob yang ditampilkan harus menyertakan gambar inline (default-nya adalah true).
includeAttachmentsBooleantrue jika array lampiran Blob yang ditampilkan harus menyertakan lampiran reguler (non-inline) (defaultnya adalah true).

Return

GmailAttachment[] — Array lampiran Blob untuk pesan 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/

getBcc()

Mendapatkan penerima yang dipisahkan koma berdasarkan pesan ini.

Pesan ini kosong untuk semua pesan yang diterima, menurut definisi.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getBcc()); // Log bcc'd addresses

Return

String — Penerima yang dipisahkan koma bcc'd di pesan 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/

Lihat juga


getBody()

Mendapatkan konten HTML dari isi pesan ini.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getBody()); // Log contents of the body

Return

String — Konten isi pesan 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/

Lihat juga


getCc()

Mendapatkan penerima yang dipisahkan koma di CC'd pada pesan ini.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getCc()); // Log cc'd addresses

Return

String — Penerima yang dipisahkan koma yang di-cc & 39;d di pesan 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/

Lihat juga


getDate()

Mendapatkan tanggal dan waktu pesan ini.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getDate()); // Log date and time of the message

Return

Date — Tanggal dan waktu pesan 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/

getFrom()

Mendapatkan pengirim pesan ini.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getFrom()); // Log from address of the message

Return

String - Alamat email pengirim 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/

Lihat juga


getHeader(name)

Mendapatkan nilai header RFC 2822 dengan nama header.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox.
var message = thread.getMessages()[0];         // Get the first message.
Logger.log(message.getHeader("Message-ID"));   // Logs the Message-ID RFC 2822 header.

Parameter

NameJenisDeskripsi
nameStringNama header RFC, tanpa titik dua yang memisahkannya dari nilai.

Return

String — Nilai header, atau string kosong jika header tidak ada dalam 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/

getId()

Mendapatkan ID pesan ini.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
var id = message.getId();
var messageById = GmailApp.getMessageById(id);
Logger.log(message.getSubject() == messageById.getMessage()); // Always logs true

Return

String — ID pesan.


getPlainBody()

Mendapatkan konten isi pesan ini tanpa format HTML. Proses ini lebih kompleks daripada getBody() dan memerlukan waktu lebih lama.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getPlainBody()); // Log contents of the body

Return

String — Konten teks biasa di pesan 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/

Lihat juga


getRawContent()

Mendapatkan konten mentah pesan ini. Hal ini setara dengan "Tampilkan Versi Asli" di UI Gmail.

Return

String — Konten mentah pesan 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/

getReplyTo()

Mendapatkan alamat balas-ke pesan ini (biasanya pengirim).

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getReplyTo()); // Logs reply-to address

Return

String — Alamat email untuk balasan.

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


getSubject()

Mendapatkan subjek pesan ini.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getSubject()); // Log subject line

Return

String — Subjek pesan 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/

Lihat juga


getThread()

Mendapatkan rangkaian pesan yang berisi pesan ini.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getThread().getFirstMessageSubject() ==
           thread.getFirstMessageSubject()); // Always logs true

Return

GmailThread — GmailThread yang berisi pesan 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/

getTo()

Mendapatkan penerima yang dipisahkan koma untuk pesan ini.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getTo()); // Log the recipient of message

Return

String — Penerima yang dipisahkan koma untuk pesan 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/

Lihat juga


isDraft()

Mendapatkan apakah pesan ini adalah draf.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is draft? " + message.isDraft());

Return

Boolean — Apakah pesan ini adalah 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/

isInChats()

Mendapatkan apakah pesan ini berupa chat.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is a chat? " + message.isInChats());

Return

Boolean — Apakah pesan ini berupa chat.


isInInbox()

Mendapatkan apakah pesan ini ada di kotak masuk.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is in inbox? " + message.isInInbox());

Return

Boolean — Apakah pesan ini ada di kotak masuk atau tidak.

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/

isInPriorityInbox()

Menampilkan true jika pesan ini berada dalam kotak masuk prioritas; menampilkan false jika tidak.

var thread = GmailApp.getPriorityInboxThreads(0,1)[0]; // Get first thread in priority inbox
var messages = thread.getMessages();
for (var i = 0; i < messages.length; i++) {
  // At least one of the messages is in priority inbox
  Logger.log("is in priority inbox? " + messages[i].isInPriorityInbox());
}

Return

Boolean — Apakah pesan ini ada di kotak masuk prioritas.

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/

isInTrash()

Mendapatkan apakah pesan ini ada di sampah.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is in the trash? " + message.isInTrash());

Return

Boolean — Apakah pesan ini ada di sampah.


isStarred()

Mendapatkan apakah pesan ini berbintang.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is starred? " + message.isStarred());

Return

Boolean — Apakah pesan ini berbintang.


isUnread()

Mendapatkan apakah pesan ini belum dibaca.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is unread? " + message.isUnread());

Return

Boolean — Status yang belum dibaca dari pesan 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/

markRead()

Menandai pesan sebagai sudah dibaca.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
message.markRead(); // Mark as read

Return

GmailMessage — GmailMessage ini, berguna untuk perantaian.

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


markUnread()

Menandai pesan sebagai belum dibaca.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
message.markUnread(); // Mark as unread

Return

GmailMessage — GmailMessage ini, berguna untuk perantaian.

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


moveToTrash()

Memindahkan pesan ke sampah.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
message.moveToTrash(); // Move message to trash

Return

GmailMessage — GmailMessage ini, berguna untuk perantaian.

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


refresh()

Memuat ulang pesan ini dan status terkait dari Gmail (berguna jika label, status baca, dll., telah berubah).

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
// .. Do bunch of stuff here
message.refresh(); // Make sure it's up to date
// Do more stuff to message

Return

GmailMessage — Pesan ini untuk perantaian.

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/

reply(body)

Balasan untuk pengirim pesan ini menggunakan alamat balas-ke. Ukuran email (termasuk header) adalah kuota terbatas.

// Respond to author of message with acknowledgment
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.reply("Got your message");

Parameter

NameJenisDeskripsi
bodyStringIsi email.

Return

GmailMessage — Pesan ini, berguna untuk pembuatan rantai.

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


reply(body, options)

Balasan untuk pengirim pesan ini menggunakan alamat balas-ke, dengan argumen opsional.

Email dapat berisi teks biasa dan badan HTML. Ukuran email (termasuk header) adalah kuota terbatas.

// Respond with HTML body text
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.reply("incapable of HTML", {
  htmlBody: "<b>some HTML body text</b>",
  noReply: true
});

Parameter

NameJenisDeskripsi
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)
noReplyBooleantrue jika email harus dikirim dari alamat email no-reply generik untuk mencegah penerima merespons email; opsi ini hanya memungkinkan untuk akun Google Workspace, bukan pengguna Gmail
replyToStringalamat email yang akan digunakan sebagai alamat balas-ke default (default: alamat email pengguna)
subjectStringbaris subjek baru untuk email

Return

GmailMessage — Pesan ini, berguna untuk pembuatan rantai.

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


replyAll(body)

Akan membalas pengirim menggunakan alamat balas-ke dan semua penerima pesan ini. Ukuran email (termasuk header) adalah kuota terbatas.

// Respond to all recipients (except bcc'd) of last email in thread with acknowledgment
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.replyAll("Got your message");

Parameter

NameJenisDeskripsi
bodyStringIsi email.

Return

GmailMessage — Pesan ini,berguna untuk jaringan bisnis.

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


replyAll(body, options)

Akan membalas pengirim pesan ini menggunakan alamat balas-ke dan semua penerima, dengan argumen opsional.

Email dapat berisi teks biasa dan badan HTML. Ukuran email (termasuk header) adalah kuota terbatas.

// Respond with HTML body text
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
messageThread.replyAll("incapable of HTML", {
  htmlBody: "<b>some HTML body text</b>",
  noReply: true
});

Parameter

NameJenisDeskripsi
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)
noReplyBooleantrue jika email harus dikirim dari alamat email no-reply generik untuk mencegah penerima merespons email; opsi ini hanya memungkinkan untuk akun Google Workspace, bukan pengguna Gmail
replyToStringalamat email yang akan digunakan sebagai alamat balas-ke default (default: alamat email pengguna)
subjectStringbaris subjek baru untuk email (maksimum 250 karakter)

Return

GmailMessage — Pesan ini, berguna untuk pembuatan rantai.

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


star()

Memberi bintang pada pesan.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
message.star(); // Star the message

Return

GmailMessage — GmailMessage ini, berguna untuk perantaian.

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


unstar()

Hapus bintang pada pesan.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
message.unstar(); // Unstar the message

Return

GmailMessage — GmailMessage ini, berguna untuk perantaian.

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