Class GmailApp

Aplikasi Gmail

Menyediakan akses ke rangkaian pesan, pesan, dan label Gmail.

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
createDraft(recipient, subject, body)	GmailDraft	Membuat draf pesan email.
createDraft(recipient, subject, body, options)	GmailDraft	Membuat draf pesan email dengan argumen opsional.
createLabel(name)	GmailLabel	Membuat label pengguna baru dari nama yang diberikan.
deleteLabel(label)	GmailApp	Menghapus label yang ditentukan.
getAliases()	String[]	Mendapatkan daftar email yang disiapkan sebagai alias untuk akun ini di Gmail.
getDraft(draftId)	GmailDraft	Ambil draf pesan email menurut ID.
getDraftMessages()	GmailMessage[]	Mengambil semua pesan draf.
getDrafts()	GmailDraft[]	Mendapatkan semua pesan draf Gmail.
getInboxThreads()	GmailThread[]	Mengambil semua rangkaian pesan Kotak Masuk terlepas dari label.
getInboxThreads(start, max)	GmailThread[]	Mengambil rentang rangkaian pesan Kotak Masuk terlepas dari label.
getInboxUnreadCount()	Integer	Mendapatkan jumlah rangkaian pesan yang belum dibaca di kotak masuk.
getMessageById(id)	GmailMessage	Mendapatkan pesan menurut ID.
getMessagesForThread(thread)	GmailMessage[]	Mengambil semua pesan di rangkaian pesan yang ditentukan.
getMessagesForThreads(threads)	GmailMessage[][]	Mengambil semua pesan di rangkaian pesan yang ditentukan.
getPriorityInboxThreads()	GmailThread[]	Mengambil semua thread Kotak Prioritas terlepas dari labelnya.
getPriorityInboxThreads(start, max)	GmailThread[]	Mengambil rentang rangkaian Kotak Prioritas, terlepas dari labelnya.
getPriorityInboxUnreadCount()	Integer	Mendapatkan jumlah rangkaian pesan yang belum dibaca dalam Kotak Prioritas.
getSpamThreads()	GmailThread[]	Mengambil semua rangkaian pesan spam terlepas dari labelnya.
getSpamThreads(start, max)	GmailThread[]	Mengambil rangkaian thread spam terlepas dari label.
getSpamUnreadCount()	Integer	Mendapatkan jumlah rangkaian pesan yang belum dibaca yang merupakan spam.
getStarredThreads()	GmailThread[]	Mengambil semua thread berbintang terlepas dari label.
getStarredThreads(start, max)	GmailThread[]	Mengambil rentang thread berbintang terlepas dari label.
getStarredUnreadCount()	Integer	Mendapatkan jumlah rangkaian pesan yang belum dibaca yang berbintang.
getThreadById(id)	GmailThread	Mendapatkan thread berdasarkan ID.
getTrashThreads()	GmailThread[]	Mengambil semua thread sampah terlepas dari labelnya.
getTrashThreads(start, max)	GmailThread[]	Mengambil kumpulan thread sampah terlepas dari labelnya.
getUserLabelByName(name)	GmailLabel	Mengambil label yang diberi nama label.
getUserLabels()	GmailLabel[]	Mengambil daftar label buatan pengguna.
markMessageRead(message)	GmailApp	Menandai pesan ini sebagai telah dibaca dan memaksa pesan tersebut untuk dimuat ulang.
markMessageUnread(message)	GmailApp	Menandai pesan ini sebagai belum dibaca dan memaksanya untuk dimuat ulang.
markMessagesRead(messages)	GmailApp	Menandai pesan ini sebagai telah dibaca dan memaksanya untuk dimuat ulang.
markMessagesUnread(messages)	GmailApp	Menandai pesan ini sebagai belum dibaca dan memaksanya untuk dimuat ulang.
markThreadImportant(thread)	GmailApp	Menandai thread ini sebagai penting dan memaksa thread untuk dimuat ulang.
markThreadRead(thread)	GmailApp	Menandai thread ini sebagai telah dibaca dan memaksa thread untuk dimuat ulang.
markThreadUnimportant(thread)	GmailApp	Menandai thread ini sebagai tidak penting dan memaksa thread untuk dimuat ulang.
markThreadUnread(thread)	GmailApp	Menandai thread ini belum dibaca dan memaksa thread untuk dimuat ulang.
markThreadsImportant(threads)	GmailApp	Menandai thread ini sebagai penting dan memaksa thread untuk dimuat ulang.
markThreadsRead(threads)	GmailApp	Menandai thread ini sebagai telah dibaca dan memaksa thread untuk dimuat ulang.
markThreadsUnimportant(threads)	GmailApp	Menandai thread ini sebagai tidak penting dan memaksa thread untuk dimuat ulang.
markThreadsUnread(threads)	GmailApp	Menandai thread ini sebagai belum dibaca dan memaksa thread untuk dimuat ulang.
moveMessageToTrash(message)	GmailApp	Memindahkan pesan ke sampah dan memaksa pesan dimuat ulang.
moveMessagesToTrash(messages)	GmailApp	Memindahkan pesan yang ditentukan ke sampah dan memaksa pesan untuk dimuat ulang.
moveThreadToArchive(thread)	GmailApp	Memindahkan thread ini ke arsip dan memaksa thread untuk dimuat ulang.
moveThreadToInbox(thread)	GmailApp	Memindahkan thread ini ke kotak masuk dan memaksa thread untuk dimuat ulang.
moveThreadToSpam(thread)	GmailApp	Memindahkan thread ini ke spam dan memaksa thread untuk dimuat ulang.
moveThreadToTrash(thread)	GmailApp	Memindahkan thread ini ke sampah dan memaksa thread untuk dimuat ulang.
moveThreadsToArchive(threads)	GmailApp	Memindahkan thread ini ke arsip dan memaksa thread untuk dimuat ulang.
moveThreadsToInbox(threads)	GmailApp	Memindahkan thread ini ke kotak masuk dan memaksa thread untuk dimuat ulang.
moveThreadsToSpam(threads)	GmailApp	Memindahkan thread ini ke spam dan memaksa thread untuk dimuat ulang.
moveThreadsToTrash(threads)	GmailApp	Memindahkan thread ini ke sampah dan memaksa thread untuk dimuat ulang.
refreshMessage(message)	GmailApp	Memuat ulang pesan dan status terkait dari Gmail (berguna jika label, status baca, dll., telah berubah).
refreshMessages(messages)	GmailApp	Memuat ulang pesan dan status terkait dari Gmail (berguna jika label, status baca, dll., telah berubah).
refreshThread(thread)	GmailApp	Memuat ulang thread dan status terkait dari Gmail (berguna jika label, status baca, dll., telah berubah).
refreshThreads(threads)	GmailApp	Memuat ulang thread dan status terkait dari Gmail (berguna jika label, status baca, dll., telah berubah).
search(query)	GmailThread[]	Menelusuri Gmail dengan kueri yang ditentukan.
search(query, start, max)	GmailThread[]	Menelusuri Gmail dengan kueri yang ditentukan.
sendEmail(recipient, subject, body)	GmailApp	Mengirim pesan email.
sendEmail(recipient, subject, body, options)	GmailApp	Mengirim pesan email dengan argumen opsional.
setCurrentMessageAccessToken(accessToken)	void	Menetapkan token akses pesan saat ini yang memungkinkan skrip mengakses properti GmailMessage saat ini.
starMessage(message)	GmailApp	Menambahkan bintang ke pesan ini dan memaksa pesan dimuat ulang.
starMessages(messages)	GmailApp	Menambahkan bintang ke pesan ini dan memaksa pesan untuk dimuat ulang.
unstarMessage(message)	GmailApp	Menghapus bintang dari pesan ini dan memaksa pesan dimuat ulang.
unstarMessages(messages)	GmailApp	Menghapus bintang dari pesan ini dan memaksa pesan dimuat ulang.

Metode yang tidak digunakan lagi

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
getChatThreads()	GmailThread[]	Mendapatkan semua rangkaian pesan Google Hangouts klasik dan rangkaian pesan Google Chat hingga Google mengalihkan semua pengguna Hangouts klasik ke Chat akhir tahun ini.
getChatThreads(start, max)	GmailThread[]	Mendapatkan berbagai rangkaian pesan Google Hangouts klasik dan rangkaian pesan Google Chat hingga Google mengalihkan semua pengguna Hangouts klasik ke Chat akhir tahun ini.

Dokumentasi mendetail

createDraft(recipient, subject, body)

Membuat draf pesan email. Ukuran email (termasuk header) adalah kuota terbatas.

// The code below creates a draft email with the current date and time.
var now = new Date();
GmailApp.createDraft("[e-mail]", "current time", "The time is: " + now.toString());

Parameter

Name	Jenis	Deskripsi
recipient	String	daftar alamat email yang dipisahkan koma
subject	String	subjek email
body	String	isi email

Return

GmailDraft — GmailDraf 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

• createDraft(recipient, subject, body, options)

---

createDraft(recipient, subject, body, options)

Membuat draf pesan email dengan argumen opsional. Email dapat berisi teks biasa atau isi HTML. Ukuran email (termasuk header, tetapi tidak termasuk lampiran) dibatasi kuota.

// Create a draft email with a file from Google Drive attached as a PDF.
var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
GmailApp.createDraft('[e-mail]', 'Attachment example', 'Please see attached file.', {
    attachments: [file.getAs(MimeType.PDF)],
    name: 'Automatic Emailer Script'
});

Parameter

Name	Jenis	Deskripsi
recipient	String	alamat penerima
subject	String	baris subjek
body	String	bagian isi email
options	Object	objek JavaScript yang menentukan parameter lanjutan, seperti yang tercantum di bawah ini

Parameter lanjutan

Name	Jenis	Deskripsi
attachments	BlobSource[]	array file yang akan dikirim dengan email
bcc	String	daftar alamat email yang dipisahkan koma ke BCC
cc	String	daftar alamat email yang dipisahkan koma untuk CC
from	String	alamat pengirim email, yang harus merupakan salah satu nilai yang ditampilkan oleh getAliases()
htmlBody	String	jika ditetapkan, perangkat yang mampu merender HTML akan menggunakannya sebagai ganti argumen isi yang diperlukan; Anda dapat menambahkan kolom inlineImages opsional di isi HTML jika Anda memiliki gambar inline untuk email
inlineImages	Object	objek 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" />
name	String	nama pengirim email (default: nama pengguna)
replyTo	String	alamat email yang akan digunakan sebagai alamat balas-ke default (default: alamat email pengguna)

Return

GmailDraft — GmailDraf 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

• createDraft(recipient, subject, body)

---

createLabel(name)

Membuat label pengguna baru dari nama yang diberikan.

// Creates the label @FOO and logs label: FOO
Logger.log("label: " + GmailApp.createLabel("FOO"));

Parameter

Name	Jenis	Deskripsi
name	String	nama label baru

Return

GmailLabel — label 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

• deleteLabel(label)

---

deleteLabel(label)

Menghapus label yang ditentukan.

// Have to get the label by name first
var label = GmailApp.getUserLabelByName("FOO");
GmailApp.deleteLabel(label);

Parameter

Name	Jenis	Deskripsi
label	GmailLabel	label yang akan dihapus

Return

GmailApp — layanan Gmail, 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

• createLabel(name)

---

getAliases()

Mendapatkan daftar email yang disiapkan sebagai alias untuk akun ini di Gmail.

Anda dapat mengirim pesan dari alias tersebut menggunakan "dari" argumen opsional.

// Log the aliases for this Gmail account and send an email as the first one.
var me = Session.getActiveUser().getEmail();
var aliases = GmailApp.getAliases();
Logger.log(aliases);
if (aliases.length > 0) {
  GmailApp.sendEmail(me, 'From an alias', 'A message from an alias!', {'from': aliases[0]});
} else {
  GmailApp.sendEmail(me, 'No aliases found', 'You have no aliases.');
}

Return

String[] — array alias untuk akun 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

• sendEmail(recipient, subject, body, options)

---

getDraft(draftId)

Ambil draf pesan email menurut ID.

Gunakan kode ini bersama dengan getId() pada draf Gmail.

// Get the first draft message in your drafts folder
var draft = GmailApp.getDrafts()[0];
// Get its ID
var draftId = draft.getId();
// Now fetch the same draft using that ID.
var draftById = GmailApp.getDraft(draftId);
// Should always log true as they should be the same message
Logger.log(draft.getMessage().getSubject() == draftById.getMessage().getSubject());

Parameter

Name	Jenis	Deskripsi
draftId	String	ID draf yang akan diambil

Return

GmailDraft — draf dengan ID yang diberikan

Menampilkan

Error — jika tidak ada draf dengan ID yang dapat ditemukan

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/

---

getDraftMessages()

Mengambil semua pesan draf.

// Logs the number of draft messages
var drafts = GmailApp.getDraftMessages();
Logger.log(drafts.length);

Return

GmailMessage[] — array draf pesan Gmail

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/

---

getDrafts()

Mendapatkan semua pesan draf Gmail.

var drafts = GmailApp.getDrafts();
for (var i = 0; i < drafts.length; i++) {
  Logger.log(drafts[i].getId());
}

Return

GmailDraft[] — array pesan draf Gmail

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/

---

getInboxThreads()

Mengambil semua rangkaian pesan Kotak Masuk terlepas dari label.

Panggilan ini akan gagal jika ukuran semua thread terlalu besar untuk ditangani sistem. Jika ukuran thread tidak diketahui, dan berpotensi sangat besar, gunakan 'paged' panggil, dan tentukan rentang thread yang akan diambil di setiap panggilan.

// Log the subject lines of your Inbox
var threads = GmailApp.getInboxThreads();
for (var i = 0; i < threads.length; i++) {
  Logger.log(threads[i].getFirstMessageSubject());
}

Return

GmailThread[] — array rangkaian pesan Gmail 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/

---

getInboxThreads(start, max)

Mengambil rentang rangkaian pesan Kotak Masuk terlepas dari label.

// Log the subject lines of up to the first 50 emails in your Inbox
var threads = GmailApp.getInboxThreads(0, 50);
for (var i = 0; i < threads.length; i++) {
  Logger.log(threads[i].getFirstMessageSubject());
}

Parameter

Name	Jenis	Deskripsi
start	Integer	indeks thread pertama yang akan diambil
max	Integer	jumlah maksimum thread yang akan diambil

Return

GmailThread[] — array rangkaian pesan Gmail 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/

---

getInboxUnreadCount()

Mendapatkan jumlah rangkaian pesan yang belum dibaca di kotak masuk.

Logger.log("Messages unread in inbox: " + GmailApp.getInboxUnreadCount());

Return

Integer — jumlah rangkaian pesan di kotak masuk yang memiliki pesan yang 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/

---

getMessageById(id)

Mendapatkan pesan menurut ID.

Gunakan ini bersama dengan getId() pada pesan Gmail.

// Get the first message in the first thread of your inbox
var message = GmailApp.getInboxThreads(0, 1)[0].getMessages()[0];
// Get its ID
var messageId = message.getId();
// Now fetch the same message using that ID.
var messageById = GmailApp.getMessageById(messageId);
// Should always log true as they should be the same message
Logger.log(message.getSubject() == messageById.getSubject());

Parameter

Name	Jenis	Deskripsi
id	String	ID pesan yang akan diambil

Return

GmailMessage — pesan dengan ID yang diberikan

Menampilkan

Error — jika pesan dengan ID yang ditentukan tidak dapat ditemukan

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

• getThreadById(id)

---

getMessagesForThread(thread)

Mengambil semua pesan di rangkaian pesan yang ditentukan.

// Log all the subject lines in the first thread of your inbox
var thread = GmailApp.getInboxThreads(0, 1)[0];
var messages = GmailApp.getMessagesForThread(thread);
for (var i = 0 ; i < messages.length; i++) {
  Logger.log("subject: " + messages[i].getSubject());
}

Parameter

Name	Jenis	Deskripsi
thread	GmailThread	rangkaian pesan yang akan diambil

Return

GmailMessage[] — array pesan yang sesuai dengan thread 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

• getMessagesForThreads(threads)

---

getMessagesForThreads(threads)

Mengambil semua pesan di rangkaian pesan yang ditentukan.

// Log the subject lines of all messages in the first two threads of your inbox
var thread = GmailApp.getInboxThreads(0, 2);
var messages = GmailApp.getMessagesForThreads(thread);
for (var i = 0 ; i < messages.length; i++) {
  for (var j = 0; j < messages[i].length; j++) {
    Logger.log("subject: " + messages[i][j].getSubject());
  }
}

Parameter

Name	Jenis	Deskripsi
threads	GmailThread[]	rangkaian pesan yang akan diambil

Return

GmailMessage[][] — array pesan, di mana setiap item dalam array luar sesuai dengan thread dan array dalam berisi pesan dalam thread tersebut

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

• getMessagesForThread(thread)

---

getPriorityInboxThreads()

Mengambil semua thread Kotak Prioritas terlepas dari labelnya.

Panggilan ini akan gagal jika ukuran semua thread terlalu besar untuk ditangani sistem. Jika ukuran thread tidak diketahui, dan berpotensi sangat besar, gunakan 'paged' panggil, dan tentukan rentang thread yang akan diambil di setiap panggilan.

Logger.log("# of messages in your Priority Inbox: " +
           GmailApp.getPriorityInboxThreads().length);

Return

GmailThread[] — array rangkaian pesan Gmail 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/

---

getPriorityInboxThreads(start, max)

Mengambil rentang rangkaian Kotak Prioritas, terlepas dari labelnya.

// Will log some number 2 or less
Logger.log("# of messages in your Priority Inbox: " +
           GmailApp.getPriorityInboxThreads(0, 2).length);

Parameter

Name	Jenis	Deskripsi
start	Integer	indeks thread pertama yang akan diambil
max	Integer	jumlah maksimum thread yang akan diambil

Return

GmailThread[] — array rangkaian pesan Gmail 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/

---

getPriorityInboxUnreadCount()

Mendapatkan jumlah rangkaian pesan yang belum dibaca dalam Kotak Prioritas.

Logger.log("Number of unread emails in your Priority Inbox : " +
           GmailApp.getPriorityInboxUnreadCount());

Return

Integer — jumlah rangkaian pesan di Kotak Prioritas yang memiliki pesan yang 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/

---

getSpamThreads()

Mengambil semua rangkaian pesan spam terlepas dari labelnya.

Panggilan ini akan gagal jika ukuran semua thread terlalu besar untuk ditangani sistem. Jika ukuran thread tidak diketahui, dan berpotensi sangat besar, gunakan 'paged' panggil, dan tentukan rentang thread yang akan diambil di setiap panggilan.

Logger.log("# of total spam threads: " + GmailApp.getSpamThreads().length);

Return

GmailThread[] — array rangkaian pesan Gmail di folder spam

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/

---

getSpamThreads(start, max)

Mengambil rangkaian thread spam terlepas dari label.

// Will log a number at most 5
Logger.log("# of total spam threads: " + GmailApp.getSpamThreads(0, 5).length);

Parameter

Name	Jenis	Deskripsi
start	Integer	indeks thread pertama yang akan diambil
max	Integer	jumlah maksimum thread yang akan diambil

Return

GmailThread[] — array rangkaian pesan Gmail di folder spam

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/

---

getSpamUnreadCount()

Mendapatkan jumlah rangkaian pesan yang belum dibaca yang merupakan spam.

// Unless you actually read stuff in your spam folder, this should be the same as
// the number of messages in your spam folder.
Logger.log("# unread threads that are spam: " + GmailApp.getSpamUnreadCount());

Return

Integer — jumlah rangkaian pesan spam yang memiliki pesan 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/

---

getStarredThreads()

Mengambil semua thread berbintang terlepas dari label.

Panggilan ini akan gagal jika ukuran semua thread terlalu besar untuk ditangani sistem. Jika ukuran thread tidak diketahui, dan berpotensi sangat besar, gunakan 'paged' panggil, dan tentukan rentang thread yang akan diambil di setiap panggilan.

// Logs the number of starred threads
Logger.log("# Starred threads: " + GmailApp.getStarredThreads().length);

Return

GmailThread[] — array rangkaian pesan Gmail yang berbintang

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/

---

getStarredThreads(start, max)

Mengambil rentang thread berbintang terlepas dari label.

// Logs the number of starred threads to a maximum of 5
Logger.log("# Starred threads: " + GmailApp.getStarredThreads(0, 5).length);

Parameter

Name	Jenis	Deskripsi
start	Integer	indeks thread pertama yang akan diambil
max	Integer	jumlah maksimum thread yang akan diambil

Return

GmailThread[] — array rangkaian pesan Gmail yang berbintang

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/

---

getStarredUnreadCount()

Mendapatkan jumlah rangkaian pesan yang belum dibaca yang berbintang.

Logger.log("# unread and starred: " + GmailApp.getStarredUnreadCount());

Return

Integer — jumlah rangkaian pesan berbintang yang memiliki pesan 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/

---

getThreadById(id)

Mendapatkan thread berdasarkan ID.

Gunakan ini bersama dengan getId() di thread Gmail.

// Thread IDs can also be found in the location bar when you have a thread open in Gmail
// get first inbox thread
var firstThread = GmailApp.getInboxThreads(0,1)[0];
// Get the same thread by ID
var threadById = GmailApp.getThreadById(firstThread.getId());
// Verify they are the same
Logger.log(firstThread.getFirstMessageSubject() == threadById.getFirstMessageSubject());

Parameter

Name	Jenis	Deskripsi
id	String	ID thread yang akan diambil

Return

GmailThread — thread dengan ID yang diberikan atau null jika tidak ditemukan

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

• getMessageById(id)

---

getTrashThreads()

Mengambil semua thread sampah terlepas dari labelnya.

Panggilan ini akan gagal jika ukuran semua thread terlalu besar untuk ditangani sistem. Jika ukuran thread tidak diketahui, dan berpotensi sangat besar, gunakan 'paged' panggil, dan tentukan rentang thread yang akan diambil di setiap panggilan.

Logger.log("# of total trash threads: " + GmailApp.getTrashThreads().length);

Return

GmailThread[] — array rangkaian pesan Gmail di sampah

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/

---

getTrashThreads(start, max)

Mengambil kumpulan thread sampah terlepas dari labelnya.

// Will log a number at most 5
Logger.log("# of total trash threads: " + GmailApp.getTrashThreads(0, 5).length);

Parameter

Name	Jenis	Deskripsi
start	Integer	indeks thread pertama yang akan diambil
max	Integer	jumlah maksimum thread yang akan diambil

Return

GmailThread[] — array rangkaian pesan Gmail di sampah

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/

---

getUserLabelByName(name)

Mengambil label yang diberi nama label.

var labelObject = GmailApp.getUserLabelByName("myLabel");

Parameter

Name	Jenis	Deskripsi
name	String	nama label yang akan diambil

Return

GmailLabel — label Gmail dengan nama yang diberikan

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/

---

getUserLabels()

Mengambil daftar label buatan pengguna.

// Logs all of the names of your labels
var labels = GmailApp.getUserLabels();
for (var i = 0; i < labels.length; i++) {
  Logger.log("label: " + labels[i].getName());
}

Return

GmailLabel[] — array label yang dibuat pengguna

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/

---

markMessageRead(message)

Menandai pesan ini sebagai telah dibaca dan memaksa pesan tersebut untuk dimuat ulang.

// Mark the first message in the first thread of your inbox as read
var message = GmailApp.getInboxThreads(0, 1)[0].getMessages()[0];
GmailApp.markMessageRead(message);

Parameter

Name	Jenis	Deskripsi
message	GmailMessage	pesan untuk ditandai sebagai telah dibaca

Return

GmailApp — layanan Gmail, 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

• markMessageUnread(message)

---

markMessageUnread(message)

Menandai pesan ini sebagai belum dibaca dan memaksanya untuk dimuat ulang.

// Mark the first message in the first thread of your inbox as unread
var message = GmailApp.getInboxThreads(0, 1)[0].getMessages()[0];
GmailApp.markMessageUnread(message);

Parameter

Name	Jenis	Deskripsi
message	GmailMessage	pesan untuk ditandai sebagai belum dibaca

Return

GmailApp — layanan Gmail, 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

• markMessageRead(message)

---

markMessagesRead(messages)

Menandai pesan ini sebagai telah dibaca dan memaksanya untuk dimuat ulang.

// Mark first three messages in the first inbox thread as read.
// Assumes that the first inbox thread has 3 messages in it.
var threadMessages = GmailApp.getInboxThreads(0, 1)[0].getMessages();
var messages = [threadMessages[0], threadMessages[1], threadMessages[2]];
GmailApp.markMessagesRead(thread.getMessages());

Parameter

Name	Jenis	Deskripsi
messages	GmailMessage[]	array pesan untuk ditandai sebagai telah dibaca

Return

GmailApp — layanan Gmail, 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

• markMessagesUnread(messages)

---

markMessagesUnread(messages)

Menandai pesan ini sebagai belum dibaca dan memaksanya untuk dimuat ulang.

// Mark first three messages in the first inbox thread as unread.
// Assumes that the first inbox thread has 3 messages in it
var threadMessages = GmailApp.getInboxThreads(0, 1)[0].getMessages();
var messages = [threadMessages[0], threadMessages[1], threadMessages[2]];
GmailApp.markMessagesUnread(thread.getMessages());

Parameter

Name	Jenis	Deskripsi
messages	GmailMessage[]	array pesan untuk ditandai sebagai belum dibaca

Return

GmailApp — layanan Gmail, 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

• markMessagesRead(messages)

---

markThreadImportant(thread)

Menandai thread ini sebagai penting dan memaksa thread untuk dimuat ulang.

// Marks first inbox thread as important
var thread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.markThreadImportant(thread);

Parameter

Name	Jenis	Deskripsi
thread	GmailThread	rangkaian pesan untuk ditandai sebagai penting

Return

GmailApp — layanan Gmail, 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

• markThreadUnimportant(thread)

---

markThreadRead(thread)

Menandai thread ini sebagai telah dibaca dan memaksa thread untuk dimuat ulang.

// Marks first inbox thread as read
var thread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.markThreadRead(thread);

Parameter

Name	Jenis	Deskripsi
thread	GmailThread	rangkaian pesan untuk ditandai sebagai telah dibaca

Return

GmailApp — layanan Gmail, 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

• markThreadUnread(thread)

---

markThreadUnimportant(thread)

Menandai thread ini sebagai tidak penting dan memaksa thread untuk dimuat ulang.

// Marks first inbox thread as unimportant
var thread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.markThreadUnimportant(thread);

Parameter

Name	Jenis	Deskripsi
thread	GmailThread	rangkaian pesan untuk ditandai sebagai tidak penting

Return

GmailApp — layanan Gmail, 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

• markThreadImportant(thread)

---

markThreadUnread(thread)

Menandai thread ini belum dibaca dan memaksa thread untuk dimuat ulang.

// Marks first inbox thread as unread
var thread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.markThreadUnread(thread);

Parameter

Name	Jenis	Deskripsi
thread	GmailThread	rangkaian pesan untuk ditandai sebagai belum dibaca

Return

GmailApp — layanan Gmail, 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

• markThreadRead(thread)

---

markThreadsImportant(threads)

Menandai thread ini sebagai penting dan memaksa thread untuk dimuat ulang.

// Marks first two threads in inbox as important
var threads = GmailApp.getInboxThreads(0, 2);
GmailApp.markThreadsImportant(threads);

Parameter

Name	Jenis	Deskripsi
threads	GmailThread[]	array thread untuk ditandai sebagai penting

Return

GmailApp — layanan Gmail, 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

• markThreadsUnimportant(threads)

---

markThreadsRead(threads)

Menandai thread ini sebagai telah dibaca dan memaksa thread untuk dimuat ulang.

// Marks first two threads in inbox as read
var threads = GmailApp.getInboxThreads(0, 2);
GmailApp.markThreadsRead(threads);

Parameter

Name	Jenis	Deskripsi
threads	GmailThread[]	array thread untuk ditandai sebagai telah dibaca

Return

GmailApp — layanan Gmail, 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

• markThreadsUnread(threads)

---

markThreadsUnimportant(threads)

Menandai thread ini sebagai tidak penting dan memaksa thread untuk dimuat ulang.

// Marks first two threads in inbox as unimportant
var threads = GmailApp.getInboxThreads(0, 2);
GmailApp.markThreadsUnimportant(threads);

Parameter

Name	Jenis	Deskripsi
threads	GmailThread[]	array thread untuk ditandai sebagai tidak penting

Return

GmailApp — layanan Gmail, 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

• markThreadsImportant(threads)

---

markThreadsUnread(threads)

Menandai thread ini sebagai belum dibaca dan memaksa thread untuk dimuat ulang.

// Marks first two threads in inbox as unread
var threads = GmailApp.getInboxThreads(0, 2);
GmailApp.markThreadsUnread(threads);

Parameter

Name	Jenis	Deskripsi
threads	GmailThread[]	array thread untuk ditandai sebagai belum dibaca

Return

GmailApp — layanan Gmail, 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

• markThreadsRead(threads)

---

moveMessageToTrash(message)

Memindahkan pesan ke sampah dan memaksa pesan dimuat ulang.

// Move the first message in your inbox to trash
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var firstMessage = firstThread.getMessages()[0];
GmailApp.moveMessageToTrash(firstMessage);

Parameter

Name	Jenis	Deskripsi
message	GmailMessage	pesan ke sampah

Return

GmailApp — layanan Gmail (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

• moveMessagesToTrash(messages)

---

moveMessagesToTrash(messages)

Memindahkan pesan yang ditentukan ke sampah dan memaksa pesan untuk dimuat ulang.

// Move first two messages in your inbox to trash
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var messages = firstThread.getMessages();
var toDelete = [messages[0], messages[1]];
GmailApp.moveMessagesToTrash(toDelete);

Parameter

Name	Jenis	Deskripsi
messages	GmailMessage[]	pesan yang akan dibuang

Return

GmailApp — layanan Gmail (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

• moveMessageToTrash(message)

---

moveThreadToArchive(thread)

Memindahkan thread ini ke arsip dan memaksa thread untuk dimuat ulang.

// Archive the first thread in your inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
GmailApp.moveThreadToArchive(firstThread);

Parameter

Name	Jenis	Deskripsi
thread	GmailThread	rangkaian pesan yang akan diarsipkan

Return

GmailApp — layanan Gmail, 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

• moveThreadToInbox(thread)
• moveThreadToSpam(thread)
• moveThreadToTrash(thread)

---

moveThreadToInbox(thread)

Memindahkan thread ini ke kotak masuk dan memaksa thread untuk dimuat ulang.

// Find a thread not already in your inbox
var thread = GmailApp.search("-in:inbox")[0]; // Get the first one
GmailApp.moveThreadToInbox(thread);

Parameter

Name	Jenis	Deskripsi
thread	GmailThread	rangkaian pesan yang akan dipindahkan ke kotak masuk

Return

GmailApp — layanan Gmail, 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

• moveThreadToTrash(thread)
• moveThreadToSpam(thread)
• moveThreadToArchive(thread)

---

moveThreadToSpam(thread)

Memindahkan thread ini ke spam dan memaksa thread untuk dimuat ulang.

// Tag first thread in inbox as spam
var firstThread = GmailApp.getInboxThreads(0,1)[0];
GmailApp.moveThreadToSpam(firstThread);

Parameter

Name	Jenis	Deskripsi
thread	GmailThread	thread untuk dipindahkan ke spam

Return

GmailApp — layanan Gmail, 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

• moveThreadToTrash(thread)
• moveThreadToInbox(thread)
• moveThreadToArchive(thread)

---

moveThreadToTrash(thread)

Memindahkan thread ini ke sampah dan memaksa thread untuk dimuat ulang.

// Move first thread in inbox to trash
var firstThread = GmailApp.getInboxThreads(0,1)[0];
GmailApp.moveThreadToTrash(firstThread);

Parameter

Name	Jenis	Deskripsi
thread	GmailThread	thread untuk dibuang

Return

GmailApp — layanan Gmail, 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

• moveThreadToInbox(thread)
• moveThreadToSpam(thread)
• moveThreadToArchive(thread)

---

moveThreadsToArchive(threads)

Memindahkan thread ini ke arsip dan memaksa thread untuk dimuat ulang.

// Move first two threads in your inbox to the archive
var firstTwoThreads = GmailApp.getInboxThreads(0,2);
GmailApp.moveThreadsToArchive(firstTwoThreads);

Parameter

Name	Jenis	Deskripsi
threads	GmailThread[]	array thread yang akan diarsipkan

Return

GmailApp — layanan Gmail, 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

• moveThreadsToInbox(threads)
• moveThreadsToSpam(threads)
• moveThreadsToTrash(threads)

---

moveThreadsToInbox(threads)

Memindahkan thread ini ke kotak masuk dan memaksa thread untuk dimuat ulang.

// Find two threads not already in your inbox
var firstTwoThreads = GmailApp.search("-in:inbox", 0, 2);
GmailApp.moveThreadsToInbox(firstTwoThreads);

Parameter

Name	Jenis	Deskripsi
threads	GmailThread[]	array thread yang akan dipindahkan ke kotak masuk

Return

GmailApp — layanan Gmail, 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

• moveThreadsToTrash(threads)
• moveThreadsToSpam(threads)
• moveThreadsToArchive(threads)

---

moveThreadsToSpam(threads)

Memindahkan thread ini ke spam dan memaksa thread untuk dimuat ulang.

// Move first two threads in your inbox to spam
var firstTwoThreads = GmailApp.getInboxThreads(0,2);
GmailApp.moveThreadsToSpam(firstTwoThreads);

Parameter

Name	Jenis	Deskripsi
threads	GmailThread[]	array thread yang akan dipindahkan ke spam

Return

GmailApp — layanan Gmail, 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

• moveThreadsToInbox(threads)
• moveThreadsToTrash(threads)
• moveThreadsToArchive(threads)

---

moveThreadsToTrash(threads)

Memindahkan thread ini ke sampah dan memaksa thread untuk dimuat ulang.

// Move first two threads in your inbox to trash
var firstTwoThreads = GmailApp.getInboxThreads(0,2);
GmailApp.moveThreadsToTrash(firstTwoThreads);

Parameter

Name	Jenis	Deskripsi
threads	GmailThread[]	array thread yang akan dibuang

Return

GmailApp — layanan Gmail, 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

• moveThreadsToInbox(threads)
• moveThreadsToSpam(threads)
• moveThreadsToArchive(threads)

---

refreshMessage(message)

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

var firstThread = GmailApp.getInboxThreads(0,1)[0];
var firstMessage = firstThread.getMessages()[0];
// ...Do something that may take a while here....
GmailApp.refreshMessage(firstMessage);
// ...Do more stuff with firstMessage...

Parameter

Name	Jenis	Deskripsi
message	GmailMessage	pesan untuk dimuat ulang

Return

GmailApp — layanan Gmail, 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

• refreshMessages(messages)

---

refreshMessages(messages)

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

var firstThread = GmailApp.getInboxThreads(0,1)[0];
var coupleOfMessages = firstThread.getMessages().slice(0, 2);
// ...Do something that may take a while here....
GmailApp.refreshMessages(coupleOfMessages);
// ...Do more stuff with coupleOfMessages...

Parameter

Name	Jenis	Deskripsi
messages	GmailMessage[]	pesan yang akan dimuat ulang

Return

GmailApp — layanan Gmail, 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

• refreshMessage(message)

---

refreshThread(thread)

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

var firstThread = GmailApp.getInboxThreads(0,1)[0];
// ...Do something that may take a while here....
GmailApp.refreshThread(firstThread);
// ... Do more stuff with the thread ...

Parameter

Name	Jenis	Deskripsi
thread	GmailThread	rangkaian pesan yang akan dimuat ulang

Return

GmailApp — layanan Gmail, 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

• refreshThreads(threads)

---

refreshThreads(threads)

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

var threads = GmailApp.getInboxThreads(0, 3);
// ...Do something that may take a while here....
GmailApp.refreshThreads(threads);
// ... Do more stuff with threads ...

Parameter

Name	Jenis	Deskripsi
threads	GmailThread[]	rangkaian pesan yang akan dimuat ulang

Return

GmailApp — layanan Gmail, 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

• refreshThread(thread)

---

search(query)

Menelusuri Gmail dengan kueri yang ditentukan.

Panggilan ini akan gagal jika ukuran semua thread terlalu besar untuk ditangani sistem. Jika ukuran thread tidak diketahui, dan berpotensi sangat besar, gunakan 'paged' panggil, dan tentukan rentang thread yang akan diambil di setiap panggilan.

// Find starred messages with subject IMPORTANT
var threads = GmailApp.search('is:starred subject:"IMPORTANT"');

Parameter

Name	Jenis	Deskripsi
query	String	kueri penelusuran, seperti yang dapat Anda ketik ke Gmail

Return

GmailThread[] — array rangkaian pesan Gmail yang cocok dengan kueri 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/

---

search(query, start, max)

Menelusuri Gmail dengan kueri yang ditentukan.

// Find starred messages with subject IMPORTANT and return second batch of 10.
// Assumes there are at least 11 of them, otherwise this will return an empty array.
var threads = GmailApp.search('is:starred subject:"IMPORTANT"', 10, 10);

Parameter

Name	Jenis	Deskripsi
query	String	kueri penelusuran, seperti yang dapat Anda ketik ke Gmail
start	Integer	indeks thread awal
max	Integer	jumlah maksimum thread yang akan ditampilkan

Return

GmailThread[] — array rangkaian pesan Gmail yang cocok dengan kueri 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/

---

sendEmail(recipient, subject, body)

Mengirim pesan email. Ukuran email (termasuk header) adalah kuota terbatas.

// The code below will send an email with the current date and time.
var now = new Date();
GmailApp.sendEmail("[e-mail]", "current time", "The time is: " + now.toString());

Parameter

Name	Jenis	Deskripsi
recipient	String	daftar alamat email yang dipisahkan koma
subject	String	subjek email (maksimum 250 karakter)
body	String	isi email

Return

GmailApp — layanan Gmail, 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

• sendEmail(recipient, subject, body, options)

---

sendEmail(recipient, subject, body, options)

Mengirim pesan email dengan argumen opsional. Email dapat berisi teks biasa atau teks HTML. Ukuran email (termasuk header, tetapi tidak termasuk lampiran) dibatasi kuota.

// Send an email with a file from Google Drive attached as a PDF.
var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
GmailApp.sendEmail('[e-mail]', 'Attachment example', 'Please see the attached file.', {
    attachments: [file.getAs(MimeType.PDF)],
    name: 'Automatic Emailer Script'
});

Parameter

Name	Jenis	Deskripsi
recipient	String	alamat penerima
subject	String	baris subjek (maksimum 250 karakter)
body	String	bagian isi email
options	Object	objek JavaScript yang menentukan parameter lanjutan, seperti yang tercantum di bawah ini

Parameter lanjutan

Name	Jenis	Deskripsi
attachments	BlobSource[]	array file yang akan dikirim dengan email
bcc	String	daftar alamat email yang dipisahkan koma ke BCC
cc	String	daftar alamat email yang dipisahkan koma untuk CC
from	String	alamat pengirim email, yang harus merupakan salah satu nilai yang ditampilkan oleh getAliases()
htmlBody	String	jika ditetapkan, perangkat yang mampu merender HTML akan menggunakannya sebagai ganti argumen isi yang diperlukan; Anda dapat menambahkan kolom inlineImages opsional di isi HTML jika Anda memiliki gambar inline untuk email
inlineImages	Object	objek 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" />
name	String	nama pengirim email (default: nama pengguna)
noReply	Boolean	true jika email harus dikirim dari alamat email no-reply generik untuk mencegah penerima merespons email; opsi ini hanya memungkinkan untuk akun Google Workspace, bukan pengguna Gmail
replyTo	String	alamat email yang akan digunakan sebagai alamat balas-ke default (default: alamat email pengguna)

Return

GmailApp — layanan Gmail, 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

• sendEmail(recipient, subject, body)

---

setCurrentMessageAccessToken(accessToken)

Menetapkan token akses pesan saat ini yang memungkinkan skrip mengakses properti GmailMessage saat ini.

Hanya project Add-on Google Workspace yang menggunakan cakupan pesan saat ini di Gmail yang memerlukan metode ini.

function handleAddonActionEvent(e) {
  var accessToken = e.messageMetadata.accessToken;
  var messageId = e.messageMetadata.messageId;
  GmailApp.setCurrentMessageAccessToken(accessToken);
  var mailMessage = GmailApp.getMessageById(messageId);
  // Do something with mailMessage
}

Parameter

Name	Jenis	Deskripsi
accessToken	String	token akses sementara yang diperoleh dari objek peristiwa tindakan add-on Gmail.

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/

---

starMessage(message)

Menambahkan bintang ke pesan ini dan memaksa pesan dimuat ulang.

// Stars the first message in the first thread in your inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
GmailApp.starMessage(message);

Parameter

Name	Jenis	Deskripsi
message	GmailMessage	pesan untuk membintangi

Return

GmailApp — layanan Gmail, 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

• starMessages(messages)

---

starMessages(messages)

Menambahkan bintang ke pesan ini dan memaksa pesan untuk dimuat ulang.

// Stars the first three messages in the first thread in your inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var coupleOfMessages = firstThread.getMessages().slice(0, 3);
GmailApp.starMessages(coupleOfMessages);

Parameter

Name	Jenis	Deskripsi
messages	GmailMessage[]	array pesan yang berbintang

Return

GmailApp — layanan Gmail, 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

• starMessage(message)

---

unstarMessage(message)

Menghapus bintang dari pesan ini dan memaksa pesan dimuat ulang.

// Unstars the first message in the first thread in your inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
GmailApp.unstarMessage(message);

Parameter

Name	Jenis	Deskripsi
message	GmailMessage	hapus bintang pesan

Return

GmailApp — layanan Gmail, 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

• unstarMessages(messages)

---

unstarMessages(messages)

Menghapus bintang dari pesan ini dan memaksa pesan dimuat ulang.

// Unstars the first three messages in the first thread in your inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var coupleOfMessages = firstThread.getMessages().slice(0, 3);
GmailApp.unstarMessages(coupleOfMessages);

Parameter

Name	Jenis	Deskripsi
messages	GmailMessage[]	array pesan untuk menghapus bintang

Return

GmailApp — layanan Gmail, 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

• unstarMessage(message)

Metode yang tidak digunakan lagi

getChatThreads()

Tidak digunakan lagi. Fungsi ini tidak digunakan lagi dan tidak boleh digunakan dalam skrip baru.

Mendapatkan semua rangkaian pesan Google Hangouts klasik dan rangkaian pesan Google Chat hingga Google mengalihkan semua pengguna Hangouts klasik ke Chat akhir tahun ini. Untuk mempelajari lebih lanjut, lihat Mempelajari peralihan dari Hangouts klasik ke Google Chat.

Panggilan ini akan gagal jika ukuran semua thread terlalu besar untuk ditangani sistem. Jika ukuran thread tidak diketahui, dan berpotensi sangat besar, gunakan 'paged' panggil, dan tentukan rentang thread yang akan diambil di setiap panggilan.

var threads = GmailApp.getChatThreads();
Logger.log("# of chat threads: " + threads.length);

Return

GmailThread[] - Array rangkaian pesan chat dari Gmail.

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/

---

getChatThreads(start, max)

Tidak digunakan lagi. Fungsi ini tidak digunakan lagi dan tidak boleh digunakan dalam skrip baru.

Mendapatkan berbagai rangkaian pesan Google Hangouts klasik dan rangkaian pesan Google Chat hingga Google mengalihkan semua pengguna Hangouts klasik ke Chat akhir tahun ini. Untuk mempelajari lebih lanjut, lihat Mempelajari peralihan dari Hangouts klasik ke Google Chat.

// Get first 50 chat threads
var threads = GmailApp.getChatThreads(0,50);
// Will log no more than 50.0
Logger.log(threads.length);
Logger.log(threads[0].getFirstMessageSubject());

Parameter

Name	Jenis	Deskripsi
start	Integer	indeks thread pertama yang akan diambil
max	Integer	jumlah maksimum thread yang akan diambil

Return

GmailThread[] — array rangkaian pesan Gmail chat

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/