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 balasan.
createDraftReply(body, options)GmailDraftMembuat draf pesan yang membalas pengirim pesan ini menggunakan alamat balasan, dengan argumen opsional.
createDraftReplyAll(body)GmailDraftMembuat draf pesan yang membalas pengirim menggunakan alamat balasan dan semua penerima pesan ini.
createDraftReplyAll(body, options)GmailDraftMembuat pesan draf yang membalas pengirim pesan ini menggunakan alamat balasan 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 yang di-bcc pada pesan ini.
getBody()StringMendapatkan konten HTML isi pesan ini.
getCc()StringMendapatkan penerima yang dipisahkan koma yang di-Cc 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 balasan pesan ini (biasanya pengirim).
getSubject()StringMendapatkan subjek pesan ini.
getThread()GmailThreadMendapatkan rangkaian pesan yang berisi pesan ini.
getTo()StringMendapatkan penerima pesan ini yang dipisahkan koma.
isDraft()BooleanMendapatkan apakah pesan ini merupakan draf.
isInChats()BooleanMendapatkan apakah pesan ini merupakan chat.
isInInbox()BooleanMendapatkan apakah pesan ini ada di kotak masuk.
isInPriorityInbox()BooleanMenampilkan true jika pesan ini ada di kotak masuk prioritas; menampilkan false jika tidak.
isInTrash()BooleanMendapatkan apakah pesan ini ada di sampah.
isStarred()BooleanMendapatkan apakah pesan ini diberi bintang.
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 dibaca, dll., telah berubah).
reply(body)GmailMessageMembalas pengirim pesan ini menggunakan alamat balasan.
reply(body, options)GmailMessageMembalas pengirim pesan ini menggunakan alamat balasan, dengan argumen opsional.
replyAll(body)GmailMessageMembalas pengirim menggunakan alamat balasan dan semua penerima pesan ini.
replyAll(body, options)GmailMessageMembalas pengirim pesan ini menggunakan alamat balasan 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 balasan. Ukuran email (termasuk header) dibatasi kuota.

// Create a draft reply to the original message with an acknowledgment.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const 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 balasan, dengan argumen opsional.

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

// Create a draft response with an HTML text body.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const 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.

Parameter lanjutan

NamaJenisDeskripsi
attachmentsBlobSource[]array file yang akan dikirim dengan email
bccStringdaftar alamat email yang dipisahkan koma untuk BCC
ccStringdaftar alamat email yang dipisahkan koma untuk disertakan dalam kolom Cc
fromStringalamat tempat email harus dikirim, yang harus berupa salah satu nilai yang ditampilkan oleh GmailApp.getAliases()
htmlBodyStringjika ditetapkan, perangkat yang dapat merender HTML akan menggunakannya, bukan argumen isi yang diperlukan; Anda dapat menambahkan kolom inlineImages opsional di isi HTML jika telah menyisipkan gambar untuk email
inlineImagesObjectobjek JavaScript yang berisi pemetaan dari kunci gambar (String) ke data gambar (BlobSource); hal ini mengasumsikan bahwa parameter htmlBody digunakan dan berisi referensi ke gambar ini dalam format <img src="cid:imageKey" />
nameStringnama pengirim email (default: nama pengguna)
replyToStringalamat email yang akan digunakan sebagai alamat balas-ke default (default: alamat email pengguna)
subjectStringBaris subjek baru untuk email, maksimal 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 balasan 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.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const 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 pesan draf yang membalas pengirim pesan ini menggunakan alamat balasan dan semua penerima, dengan argumen opsional.

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

// Create a draft response to all recipients (except those bcc'd) using an HTML
// text body.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const 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.

Parameter lanjutan

NamaJenisDeskripsi
attachmentsBlobSource[]array file yang akan dikirim dengan email
bccStringdaftar alamat email yang dipisahkan koma untuk BCC
ccStringdaftar alamat email yang dipisahkan koma untuk disertakan dalam kolom Cc
fromStringalamat tempat email harus dikirim, yang harus berupa salah satu nilai yang ditampilkan oleh GmailApp.getAliases()
htmlBodyStringjika ditetapkan, perangkat yang dapat merender HTML akan menggunakannya, bukan argumen isi yang diperlukan; Anda dapat menambahkan kolom inlineImages opsional di isi HTML jika telah menyisipkan gambar untuk email
inlineImagesObjectobjek JavaScript yang berisi pemetaan dari kunci gambar (String) ke data gambar (BlobSource); hal ini mengasumsikan bahwa parameter htmlBody digunakan dan berisi referensi ke gambar ini dalam format <img src="cid:imageKey" />
nameStringnama pengirim email (default: nama pengguna)
replyToStringalamat email yang akan digunakan sebagai alamat balas-ke default (default: alamat email pengguna)
subjectStringBaris subjek baru untuk email, maksimal 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) dibatasi kuota.

// Forward first message of first inbox thread to recipient1 & recipient2,
// both @example.com
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const 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 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 kuota.

const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const 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.

Parameter lanjutan

NamaJenisDeskripsi
attachmentsBlobSource[]array file yang akan dikirim dengan email
bccStringdaftar alamat email yang dipisahkan koma untuk BCC
ccStringdaftar alamat email yang dipisahkan koma untuk disertakan dalam kolom Cc
fromStringalamat tempat email harus dikirim, yang harus berupa salah satu nilai yang ditampilkan oleh GmailApp.getAliases()
htmlBodyStringjika ditetapkan, perangkat yang dapat merender HTML akan menggunakannya, bukan argumen isi yang diperlukan; Anda dapat menambahkan kolom inlineImages opsional di isi HTML jika telah menyisipkan gambar untuk email
inlineImagesObjectobjek JavaScript yang berisi pemetaan dari kunci gambar (String) ke data gambar (BlobSource); hal ini mengasumsikan bahwa parameter htmlBody digunakan dan berisi referensi ke gambar ini dalam format <img src="cid:imageKey" />
nameStringnama pengirim email (default: nama pengguna)
noReplyBooleantrue jika email harus dikirim dari alamat email umum yang tidak dapat membalas untuk mencegah penerima merespons email; opsi ini hanya dapat dilakukan 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.

Pulang pergi

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.

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.

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) (defaultnya 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 penerima yang dipisahkan koma yang di-bcc pada pesan ini.

Secara default, kolom ini kosong untuk semua pesan yang diterima.

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

Pulang pergi

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

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

Pulang pergi

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 pada pesan ini.

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

Pulang pergi

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


getDate()

Mendapatkan tanggal dan waktu pesan ini.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const 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.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const 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.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox.
const 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.

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.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
const id = message.getId();
const 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. Hal ini lebih kompleks daripada getBody() dan memerlukan waktu lebih lama.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const 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. Tindakan ini sama dengan "Tampilkan Versi Asli" di 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 balasan pesan ini (biasanya pengirim).

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const 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.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const 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.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const 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 pesan ini yang dipisahkan koma.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const 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.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(`is draft? ${message.isDraft()}`);

Pulang pergi

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

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const 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.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const 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 ada di kotak masuk prioritas; menampilkan false jika tidak.

const thread = GmailApp.getPriorityInboxThreads(
    0, 1)[0];  // Get first thread in priority inbox
const messages = thread.getMessages();
for (let 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 ada di kotak masuk prioritas.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut atau cakupan yang sesuai dari REST API terkait:

  • https://mail.google.com/

isInTrash()

Mendapatkan apakah pesan ini ada di sampah.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(`is in the trash? ${message.isInTrash()}`);

Pulang pergi

Boolean — Apakah pesan ini ada di sampah.


isStarred()

Mendapatkan apakah pesan ini diberi bintang.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const 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.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const 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.

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

Pulang pergi

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


markUnread()

Menandai pesan sebagai belum dibaca.

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

Pulang pergi

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


moveToTrash()

Memindahkan pesan ke sampah.

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

Pulang pergi

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


refresh()

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

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const 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 penyambungan.

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 pengirim pesan ini menggunakan alamat balasan. Ukuran email (termasuk header) dibatasi kuota.

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

Parameter

NamaJenisDeskripsi
bodyStringIsi email.

Pulang pergi

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 pengirim pesan ini menggunakan alamat balasan, dengan argumen opsional.

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

// Respond with HTML body text
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const 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.

Parameter lanjutan

NamaJenisDeskripsi
attachmentsBlobSource[]array file yang akan dikirim dengan email
bccStringdaftar alamat email yang dipisahkan koma untuk BCC
ccStringdaftar alamat email yang dipisahkan koma untuk disertakan dalam kolom Cc
fromStringalamat tempat email harus dikirim, yang harus berupa salah satu nilai yang ditampilkan oleh GmailApp.getAliases()
htmlBodyStringjika ditetapkan, perangkat yang dapat merender HTML akan menggunakannya, bukan argumen isi yang diperlukan; Anda dapat menambahkan kolom inlineImages opsional di isi HTML jika telah menyisipkan gambar untuk email
inlineImagesObjectobjek JavaScript yang berisi pemetaan dari kunci gambar (String) ke data gambar (BlobSource); hal ini mengasumsikan bahwa parameter htmlBody digunakan dan berisi referensi ke gambar ini dalam format <img src="cid:imageKey" />
nameStringnama pengirim email (default: nama pengguna)
noReplyBooleantrue jika email harus dikirim dari alamat email umum yang tidak dapat membalas untuk mencegah penerima merespons email; opsi ini hanya dapat dilakukan 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.

Pulang pergi

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 pengirim menggunakan alamat balasan dan semua penerima pesan ini. Ukuran email (termasuk header) dibatasi kuota.

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

Parameter

NamaJenisDeskripsi
bodyStringIsi email.

Pulang pergi

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 pengirim pesan ini menggunakan alamat balasan dan semua penerima, dengan argumen opsional.

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

// Respond with HTML body text
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
message.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.

Parameter lanjutan

NamaJenisDeskripsi
attachmentsBlobSource[]array file yang akan dikirim dengan email
bccStringdaftar alamat email yang dipisahkan koma untuk BCC
ccStringdaftar alamat email yang dipisahkan koma untuk disertakan dalam kolom Cc
fromStringalamat tempat email harus dikirim, yang harus berupa salah satu nilai yang ditampilkan oleh GmailApp.getAliases()
htmlBodyStringjika ditetapkan, perangkat yang dapat merender HTML akan menggunakannya, bukan argumen isi yang diperlukan; Anda dapat menambahkan kolom inlineImages opsional di isi HTML jika telah menyisipkan gambar untuk email
inlineImagesObjectobjek JavaScript yang berisi pemetaan dari kunci gambar (String) ke data gambar (BlobSource); hal ini mengasumsikan bahwa parameter htmlBody digunakan dan berisi referensi ke gambar ini dalam format <img src="cid:imageKey" />
nameStringnama pengirim email (default: nama pengguna)
noReplyBooleantrue jika email harus dikirim dari alamat email umum yang tidak dapat membalas untuk mencegah penerima merespons email; opsi ini hanya dapat dilakukan 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.

Pulang pergi

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.

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

Pulang pergi

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


unstar()

Menghapus bintang pada pesan.

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

Pulang pergi

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