Class GmailMessage

Pesan Gmail

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-dengan, 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 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 karena pesan ini.
getBody()StringMendapatkan konten HTML isi pesan ini.
getCc()StringMendapatkan penerima yang dipisahkan koma yang di-CC dalam 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 dari 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 berupa draf.
isInChats()BooleanMendapatkan apakah pesan ini merupakan chat.
isInInbox()BooleanMendapatkan apakah pesan ini ada di kotak masuk atau tidak.
isInPriorityInbox()BooleanMenampilkan true jika pesan ini ada dalam kotak prioritas; akan menampilkan false jika tidak ada.
isInTrash()BooleanMendapatkan apakah pesan ini berada di sampah.
isStarred()BooleanMendapatkan apakah pesan ini berbintang.
isUnread()BooleanMendapatkan apakah pesan ini belum dibaca atau tidak.
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()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

NamaTypeDeskripsi
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-dengan, 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

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

Parameter lanjutan

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

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

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

Parameter lanjutan

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

NamaTypeDeskripsi
recipientStringDaftar alamat email yang dipisahkan koma.

Return

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

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

Parameter lanjutan

NamaTypeDeskripsi
attachmentsBlobSource[]array file yang akan dikirim dengan email
bccStringdaftar alamat email yang dipisahkan koma ke BCC
ccStringdaftar alamat email yang dipisahkan koma ke CC
fromStringalamat asal email, yang harus berupa salah satu nilai yang ditampilkan oleh GmailApp.getAliases()
htmlBodyStringjika disetel, perangkat yang mampu merender HTML menggunakannya sebagai ganti argumen isi yang diperlukan; Anda dapat menambahkan kolom inlineImages opsional dalam isi HTML jika memiliki gambar sisipan 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 tersebut dalam format <img src="cid:imageKey" />
nameStringnama pengirim email (default: nama pengguna)
noReplyBooleantrue jika email harus dikirim dari alamat email generik yang tidak dibalas 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, maksimal 250 karakter.

Return

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.

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

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

Parameter lanjutan

NamaTypeDeskripsi
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 karena pesan ini.

Tidak ada definisi 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 — Penerima yang dipisahkan koma karena menyertakan 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 penerima yang dipisahkan koma yang di-CC dalam 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 dalam 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

NamaTypeDeskripsi
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 dari 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 isi biasa 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/

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 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 berupa 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 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 merupakan 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 merupakan chat.


isInInbox()

Mendapatkan apakah pesan ini ada di kotak masuk atau tidak.

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 ada dalam kotak prioritas; akan menampilkan false jika tidak ada.

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 dalam 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 berbintang.


isUnread()

Mendapatkan apakah pesan ini belum dibaca atau tidak.

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

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

NamaTypeDeskripsi
bodyStringIsi email.

Return

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

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

Parameter lanjutan

NamaTypeDeskripsi
attachmentsBlobSource[]array file yang akan dikirim dengan email
bccStringdaftar alamat email yang dipisahkan koma ke BCC
ccStringdaftar alamat email yang dipisahkan koma ke CC
fromStringalamat asal email, yang harus berupa salah satu nilai yang ditampilkan oleh GmailApp.getAliases()
htmlBodyStringjika disetel, perangkat yang mampu merender HTML menggunakannya sebagai ganti argumen isi yang diperlukan; Anda dapat menambahkan kolom inlineImages opsional dalam isi HTML jika memiliki gambar sisipan 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 tersebut dalam format <img src="cid:imageKey" />
nameStringnama pengirim email (default: nama pengguna)
noReplyBooleantrue jika email harus dikirim dari alamat email generik yang tidak dibalas 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, maksimal 250 karakter.

Return

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

NamaTypeDeskripsi
bodyStringIsi email.

Return

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

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

Parameter lanjutan

NamaTypeDeskripsi
attachmentsBlobSource[]array file yang akan dikirim dengan email
bccStringdaftar alamat email yang dipisahkan koma ke BCC
ccStringdaftar alamat email yang dipisahkan koma ke CC
fromStringalamat asal email, yang harus berupa salah satu nilai yang ditampilkan oleh GmailApp.getAliases()
htmlBodyStringjika disetel, perangkat yang mampu merender HTML menggunakannya sebagai ganti argumen isi yang diperlukan; Anda dapat menambahkan kolom inlineImages opsional dalam isi HTML jika memiliki gambar sisipan 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 tersebut dalam format <img src="cid:imageKey" />
nameStringnama pengirim email (default: nama pengguna)
noReplyBooleantrue jika email harus dikirim dari alamat email generik yang tidak dibalas 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, maksimal 250 karakter.

Return

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

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