Class GmailMessage

GmailMessage

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 dalam 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 Bcc penerima yang dipisahkan koma pada pesan ini.
getBody()StringMendapatkan konten HTML isi pesan ini.
getCc()StringMendapatkan Cc penerima yang dipisahkan koma pada pesan ini.
getDate()DateMendapatkan tanggal dan waktu pesan ini.
getFrom()StringMendapatkan pengirim pesan ini.
getHeader(name)StringMendapatkan nilai header RFC 2822 berdasarkan nama header.
getId()StringMendapatkan ID pesan ini.
getPlainBody()StringMendapatkan konten isi pesan ini tanpa pemformatan 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 merupakan draf.
isInChats()BooleanMendapatkan apakah pesan ini adalah chat.
isInInbox()BooleanMendapatkan apakah pesan ini ada di kotak masuk.
isInPriorityInbox()BooleanMenampilkan true jika pesan ini berada dalam kotak prioritas; menampilkan false jika sebaliknya.
isInTrash()BooleanMendapatkan apakah pesan ini berada di sampah.
isStarred()BooleanMendapatkan apakah pesan ini berbintang.
isUnread()BooleanMendapatkan apakah pesan ini belum dibaca.
markRead()GmailMessageMenandai pesan sebagai telah 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 telah dibaca, dan lain-lain, telah berubah).
reply(body)GmailMessageMembalas ke pengirim pesan ini menggunakan alamat balas-ke.
reply(body, options)GmailMessageMembalas ke pengirim pesan ini menggunakan alamat balas-ke, dengan argumen opsional.
replyAll(body)GmailMessageMembalas ke pengirim menggunakan alamat balas-ke dan semua penerima pesan ini.
replyAll(body, options)GmailMessageMembalas ke pengirim pesan ini menggunakan alamat balas-ke dan semua penerima, dengan argumen opsional.
star()GmailMessageMembintangi pesan.
unstar()GmailMessageMenghapus bintang pesan.

Dokumentasi mendetail

createDraftReply(body)

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

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

NamaJenisDeskripsi
bodyStringIsi email.

Pulang pergi

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

NamaJenisDeskripsi
bodyStringIsi email.
optionsObjectObjek JavaScript yang menentukan parameter lanjutan, seperti yang tercantum di bawah ini.

Parameter lanjutan

NamaJenisDeskripsi
attachmentsBlobSource[]sebuah rangkaian file untuk dikirim melalui email
bccStringdaftar alamat email yang dipisahkan koma ke BCC
ccStringdaftar alamat email yang dipisahkan koma ke CC
fromStringalamat asal email, yang harus satu dari nilai yang ditampilkan oleh GmailApp.getAliases()
htmlBodyStringketika disetel, perangkat yang mampu merender HTML akan menggunakannya argumen body yang diperlukan; Anda dapat menambahkan kolom inlineImages opsional di isi HTML jika Anda memiliki gambar sisipan 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 untuk digunakan sebagai alamat balas-ke default (default: alamat email pengguna)
subjectStringBaris subjek baru untuk email, hingga 250 karakter.

Pulang pergi

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

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

NamaJenisDeskripsi
bodyStringIsi email.

Pulang pergi

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

NamaJenisDeskripsi
bodyStringIsi email.
optionsObjectObjek JavaScript yang menentukan parameter lanjutan, seperti yang tercantum di bawah ini.

Parameter lanjutan

NamaJenisDeskripsi
attachmentsBlobSource[]sebuah rangkaian file untuk dikirim melalui email
bccStringdaftar alamat email yang dipisahkan koma ke BCC
ccStringdaftar alamat email yang dipisahkan koma ke CC
fromStringalamat asal email, yang harus satu dari nilai yang ditampilkan oleh GmailApp.getAliases()
htmlBodyStringketika disetel, perangkat yang mampu merender HTML akan menggunakannya argumen body yang diperlukan; Anda dapat menambahkan kolom inlineImages opsional di isi HTML jika Anda memiliki gambar sisipan 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 untuk digunakan sebagai alamat balas-ke default (default: alamat email pengguna)
subjectStringBaris subjek baru untuk email, hingga 250 karakter.

Pulang pergi

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

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

NamaJenisDeskripsi
recipientStringDaftar alamat email yang dipisahkan koma.

Pulang pergi

GmailMessage — Pesan 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


forward(recipient, options)

Meneruskan pesan ini ke penerima baru, dengan argumen opsional.

Email dapat berisi teks biasa, juga isi HTML. Ukuran email (termasuk header) adalah quota 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

NamaJenisDeskripsi
recipientStringDaftar alamat email yang dipisahkan koma.
optionsObjectObjek JavaScript yang menentukan parameter lanjutan, seperti yang tercantum di bawah ini.

Parameter lanjutan

NamaJenisDeskripsi
attachmentsBlobSource[]sebuah rangkaian file untuk dikirim melalui email
bccStringdaftar alamat email yang dipisahkan koma ke BCC
ccStringdaftar alamat email yang dipisahkan koma ke CC
fromStringalamat asal email, yang harus satu dari nilai yang ditampilkan oleh GmailApp.getAliases()
htmlBodyStringketika disetel, perangkat yang mampu merender HTML akan menggunakannya argumen body yang diperlukan; Anda dapat menambahkan kolom inlineImages opsional di isi HTML jika Anda memiliki gambar sisipan 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)
noReplyBooleantrue jika email harus dikirim dari email alamat email yang tidak dibalas untuk mencegah penerima membalas email; opsi ini hanya dapat dilakukan untuk akun Google Workspace, bukan pengguna Gmail
replyToStringalamat email untuk digunakan sebagai alamat balas-ke default (default: alamat email pengguna)
subjectStringBaris subjek baru untuk email, hingga 250 karakter.

Pulang pergi

GmailMessage — Pesan 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


getAttachments()

Mendapatkan semua lampiran untuk pesan ini.

Pulang pergi

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

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

Parameter lanjutan

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

Pulang pergi

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 Bcc penerima yang dipisahkan koma pada pesan ini.

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

Pulang pergi

String — Penerima yang dipisahkan koma yang disertakan pada 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 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

Pulang pergi

String — Isi 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 Cc penerima yang dipisahkan koma 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

Pulang pergi

String — Penerima yang dipisahkan koma di-Cc pada 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

Pulang pergi

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

Pulang pergi

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

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

Pulang pergi

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

Pulang pergi

String — ID pesan.


getPlainBody()

Mendapatkan konten isi pesan ini tanpa pemformatan HTML. Ini lebih kompleks dibandingkan 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

Pulang pergi

String — Konten isi biasa 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. Ini setara dengan "Tampilkan yang Asli" pada UI Gmail.

Pulang pergi

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

Pulang pergi

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

Pulang pergi

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

Pulang pergi

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

Pulang pergi

String — Penerima pesan ini yang dipisahkan koma.

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 merupakan 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());

Pulang pergi

Boolean — Apakah pesan ini berupa 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 adalah 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());

Pulang pergi

Boolean — Apakah pesan ini merupakan 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());

Pulang pergi

Boolean — Apakah pesan ini ada di kotak masuk.

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 prioritas; menampilkan false jika sebaliknya.

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());
}

Pulang pergi

Boolean — Apakah pesan ini berada di kotak 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 berada 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());

Pulang pergi

Boolean — Apakah pesan ini berada 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());

Pulang pergi

Boolean — Apakah pesan ini diberi bintang.


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());

Pulang pergi

Boolean — Status pesan ini belum dibaca.

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

Pulang pergi

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

Pulang pergi

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

Pulang pergi

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 telah dibaca, dan lain-lain, 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

Pulang pergi

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)

Membalas ke pengirim pesan ini menggunakan alamat balas-ke. Ukuran email (termasuk header) adalah quota 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

NamaJenisDeskripsi
bodyStringIsi email.

Pulang pergi

GmailMessage — Pesan 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


reply(body, options)

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

Email dapat berisi teks biasa, juga isi HTML. Ukuran email (termasuk header) adalah quota 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

NamaJenisDeskripsi
bodyStringIsi email.
optionsObjectObjek JavaScript yang menentukan parameter lanjutan, seperti yang tercantum di bawah ini.

Parameter lanjutan

NamaJenisDeskripsi
attachmentsBlobSource[]sebuah rangkaian file untuk dikirim melalui email
bccStringdaftar alamat email yang dipisahkan koma ke BCC
ccStringdaftar alamat email yang dipisahkan koma ke CC
fromStringalamat asal email, yang harus satu dari nilai yang ditampilkan oleh GmailApp.getAliases()
htmlBodyStringketika disetel, perangkat yang mampu merender HTML akan menggunakannya argumen body yang diperlukan; Anda dapat menambahkan kolom inlineImages opsional di isi HTML jika Anda memiliki gambar sisipan 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)
noReplyBooleantrue jika email harus dikirim dari email alamat email yang tidak dibalas untuk mencegah penerima membalas email; opsi ini hanya dapat dilakukan untuk akun Google Workspace, bukan pengguna Gmail
replyToStringalamat email untuk digunakan sebagai alamat balas-ke default (default: alamat email pengguna)
subjectStringBaris subjek baru untuk email, hingga 250 karakter.

Pulang pergi

GmailMessage — Pesan 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


replyAll(body)

Membalas ke pengirim menggunakan alamat balas-ke dan semua penerima pesan ini. Ukuran email (termasuk header) 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

NamaJenisDeskripsi
bodyStringIsi email.

Pulang pergi

GmailMessage — Pesan 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


replyAll(body, options)

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

Email dapat berisi teks biasa, juga isi HTML. Ukuran email (termasuk header) adalah quota 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

NamaJenisDeskripsi
bodyStringIsi email.
optionsObjectObjek JavaScript yang menentukan parameter lanjutan, seperti yang tercantum di bawah ini.

Parameter lanjutan

NamaJenisDeskripsi
attachmentsBlobSource[]sebuah rangkaian file untuk dikirim melalui email
bccStringdaftar alamat email yang dipisahkan koma ke BCC
ccStringdaftar alamat email yang dipisahkan koma ke CC
fromStringalamat asal email, yang harus satu dari nilai yang ditampilkan oleh GmailApp.getAliases()
htmlBodyStringketika disetel, perangkat yang mampu merender HTML akan menggunakannya argumen body yang diperlukan; Anda dapat menambahkan kolom inlineImages opsional di isi HTML jika Anda memiliki gambar sisipan 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)
noReplyBooleantrue jika email harus dikirim dari email alamat email yang tidak dibalas untuk mencegah penerima membalas email; opsi ini hanya dapat dilakukan untuk akun Google Workspace, bukan pengguna Gmail
replyToStringalamat email untuk digunakan sebagai alamat balas-ke default (default: alamat email pengguna)
subjectStringBaris subjek baru untuk email, hingga 250 karakter.

Pulang pergi

GmailMessage — Pesan 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


star()

Membintangi 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

Pulang pergi

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()

Menghapus bintang 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

Pulang pergi

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