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 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 yang diberi nama header.
getId()StringMendapatkan ID pesan ini.
getPlainBody()StringMendapatkan konten pesan ini tanpa format HTML.
getRawContent()StringMendapatkan konten mentah pesan ini.
getReplyTo()StringMendapatkan alamat balas-ke untuk 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 berada di kotak masuk.
isInPriorityInbox()BooleanMenampilkan true jika pesan ini berada di kotak prioritas; menampilkan false jika tidak ada di kotak prioritas.
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 baca, dll., 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()GmailMessageMemberi bintang pada pesan.
unstar()GmailMessageMenghapus bintang pada pesan.

Dokumentasi mendetail

createDraftReply(body)

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

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

Return

GmailDraft — Draf pesan 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) memiliki 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[]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 ditetapkan, perangkat yang dapat 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)
subjectStringBaris subjek baru untuk email, maksimal 250 karakter.

Return

GmailDraft — Draf pesan 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) dibatasi 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.

Return

GmailDraft — Draf pesan 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) memiliki 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[]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 ditetapkan, perangkat yang dapat 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)
subjectStringBaris subjek baru untuk email, maksimal 250 karakter.

Return

GmailDraft — Draf pesan 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) dibatasi 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.

Return

GmailMessage — Pesan ini, berguna untuk membuat 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 juga isi HTML. Ukuran email (termasuk header) dibatasi.

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[]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 ditetapkan, perangkat yang dapat 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)
noReplyBooleantrue jika email harus dikirim dari alamat email jangan balas email umum agar penerima tidak membalas email; opsi ini hanya dapat digunakan oleh 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, maksimal 250 karakter.

Return

GmailMessage — Pesan ini, berguna untuk membuat 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

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

Parameter lanjutan

NamaJenisDeskripsi
includeInlineImagesBooleantrue jika array lampiran Blob yang ditampilkan harus menyertakan gambar inline (defaultnya adalah true).
includeAttachmentsBooleantrue jika array lampiran Blob yang ditampilkan harus menyertakan lampiran reguler (non-inline) (default-nya 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 bcc penerima yang dipisahkan koma pada pesan ini.

Menurut definisi, ini kosong untuk semua pesan yang diterima.

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 — Bcc penerima yang dipisahkan koma 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

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

Return

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

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 yang diberi 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 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 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 dasar 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 sama 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 untuk 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 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());

Return

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

Return

Boolean — Apakah pesan ini adalah chat.


isInInbox()

Mendapatkan apakah pesan ini berada 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 berada 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 di kotak prioritas; menampilkan false jika tidak ada di kotak prioritas.

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

Return

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

Return

Boolean — Apakah pesan ini dibintangi.


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

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)

Membalas ke pengirim pesan ini menggunakan alamat balas-ke. Ukuran email (termasuk header) dibatasi.

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

Return

GmailMessage — Pesan ini, berguna untuk membuat 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)

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

Email dapat berisi teks biasa dan juga isi HTML. Ukuran email (termasuk header) dibatasi.

// 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[]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 ditetapkan, perangkat yang dapat 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)
noReplyBooleantrue jika email harus dikirim dari alamat email jangan balas email umum agar penerima tidak membalas email; opsi ini hanya dapat digunakan oleh 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, maksimal 250 karakter.

Return

GmailMessage — Pesan ini, berguna untuk membuat 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)

Membalas ke pengirim menggunakan alamat balas-ke dan semua penerima pesan ini. Ukuran email (termasuk header) memiliki kuota yang dibatasi.

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

Return

GmailMessage — Pesan ini,berguna untuk membuat 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, options)

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

Email dapat berisi teks biasa dan juga isi HTML. Ukuran email (termasuk header) dibatasi.

// 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[]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 ditetapkan, perangkat yang dapat 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)
noReplyBooleantrue jika email harus dikirim dari alamat email jangan balas email umum agar penerima tidak membalas email; opsi ini hanya dapat digunakan oleh 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, maksimal 250 karakter.

Return

GmailMessage — Pesan ini, berguna untuk membuat 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()

Menghapus 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