Class GmailThread

GmailThread

ชุดข้อความในบัญชี Gmail ของผู้ใช้

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
addLabel(label)GmailThreadเพิ่มป้ายกำกับนี้ในชุดข้อความนี้
createDraftReply(body)GmailDraftสร้างข้อความร่างที่ตอบผู้ส่งข้อความสุดท้ายในชุดข้อความนี้โดยใช้ ที่อยู่สำหรับตอบกลับ
createDraftReply(body, options)GmailDraftสร้างข้อความร่างที่ตอบผู้ส่งข้อความสุดท้ายในชุดข้อความนี้โดยใช้ ที่อยู่สำหรับตอบกลับ พร้อมด้วยอาร์กิวเมนต์ที่เลือกระบุได้
createDraftReplyAll(body)GmailDraftสร้างข้อความร่างที่ตอบผู้ส่งข้อความสุดท้ายในชุดข้อความนี้ โดยใช้ ที่อยู่ตอบกลับและผู้รับทั้งหมดของข้อความนี้
createDraftReplyAll(body, options)GmailDraftสร้างข้อความร่างที่ตอบผู้ส่งข้อความสุดท้ายในชุดข้อความนี้ โดยใช้ ที่อยู่สำหรับตอบกลับและผู้รับทั้งหมด พร้อมด้วยอาร์กิวเมนต์ที่ไม่บังคับ
getFirstMessageSubject()Stringรับเรื่องของข้อความแรกในชุดข้อความ
getId()Stringรับรหัสของชุดข้อความนี้
getLabels()GmailLabel[]แสดงป้ายกำกับที่ผู้ใช้สร้างในชุดข้อความนี้
getLastMessageDate()Dateรับข้อมูลวันที่ของข้อความล่าสุดของชุดข้อความนี้
getMessageCount()Integerแสดงผลจำนวนข้อความในชุดข้อความ
getMessages()GmailMessage[]รับข้อความในชุดข้อความนี้
getPermalink()Stringรับลิงก์ถาวรสำหรับชุดข้อความนี้
hasStarredMessages()Booleanแสดงผลว่าชุดข้อความมีข้อความที่ติดดาวหรือไม่
isImportant()Booleanแสดงผลว่ามีการทำเครื่องหมายชุดข้อความว่าสำคัญหรือไม่
isInChats()Booleanแสดงผลว่าชุดข้อความมีป้ายกำกับแชทหรือไม่
isInInbox()Booleanแสดงผลว่าชุดข้อความอยู่ในกล่องจดหมายหรือไม่
isInPriorityInbox()Booleanแสดงค่า "จริง" หากชุดข้อความนี้อยู่ในกล่องจดหมายลำดับความสำคัญ จะแสดงผลเป็น "เท็จ" หากไม่เป็นเช่นนั้น
isInSpam()Booleanแสดงผลว่ามีการทำเครื่องหมายชุดข้อความว่าเป็นสแปมหรือไม่
isInTrash()Booleanแสดงผลว่าชุดข้อความอยู่ในถังขยะหรือไม่
isUnread()Booleanแสดงผลว่าชุดข้อความมีข้อความที่ยังไม่ได้อ่าน
markImportant()GmailThreadทำเครื่องหมายชุดข้อความนี้ว่าสำคัญ
markRead()GmailThreadทำเครื่องหมายชุดข้อความนี้ว่าอ่านแล้ว
markUnimportant()GmailThreadทำเครื่องหมายชุดข้อความนี้ว่าไม่สำคัญ
markUnread()GmailThreadทำเครื่องหมายชุดข้อความนี้ว่ายังไม่อ่าน
moveToArchive()GmailThreadย้ายชุดข้อความนี้ไปยังที่เก็บถาวร
moveToInbox()GmailThreadย้ายชุดข้อความนี้ไปยังกล่องจดหมาย
moveToSpam()GmailThreadย้ายชุดข้อความนี้ไปยังโฟลเดอร์จดหมายขยะ
moveToTrash()GmailThreadย้ายชุดข้อความนี้ไปที่ถังขยะ
refresh()GmailThreadโหลดชุดข้อความนี้ซ้ำและสถานะที่เกี่ยวข้องจาก Gmail (มีประโยชน์ในกรณีป้ายกำกับ สถานะการอ่าน เป็นต้น)
removeLabel(label)GmailThreadนำป้ายกำกับนี้ออกจากชุดข้อความ
reply(body)GmailThreadตอบผู้ส่งข้อความล่าสุดในชุดข้อความนี้โดยใช้อีเมลตอบกลับ
reply(body, options)GmailThreadตอบผู้ส่งข้อความล่าสุดในชุดข้อความนี้โดยใช้ที่อยู่สำหรับตอบกลับ (ไม่บังคับ) อาร์กิวเมนต์
replyAll(body)GmailThreadตอบผู้ส่ง (โดยใช้ที่อยู่สำหรับตอบกลับ) และผู้รับทั้งหมดของข้อความสุดท้ายใน ชุดข้อความ
replyAll(body, options)GmailThreadตอบผู้ส่ง (โดยใช้ที่อยู่ replyTo) และผู้รับทั้งหมดของข้อความล่าสุด ในชุดข้อความนี้ พร้อมด้วยอาร์กิวเมนต์ที่ไม่บังคับ

เอกสารโดยละเอียด

addLabel(label)

เพิ่มป้ายกำกับนี้ในชุดข้อความนี้

// Add label MyLabel to the first thread in the inbox
var label = GmailApp.getUserLabelByName("MyLabel");
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.addLabel(label);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
labelGmailLabelป้ายกำกับที่จะใช้กับชุดข้อความนี้

รีเทิร์น

GmailThread — ชุดข้อความนี้มีประโยชน์สำหรับการทำสายโซ่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

  • https://mail.google.com/

ดูเพิ่มเติม


createDraftReply(body)

สร้างข้อความร่างที่ตอบผู้ส่งข้อความสุดท้ายในชุดข้อความนี้โดยใช้ ที่อยู่สำหรับตอบกลับ ขนาดของอีเมล (รวมส่วนหัว) จะมีโควต้าจำกัด

// Create a draft reply to the message author with an acknowledgement.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.createDraftReply("Got your message");

พารามิเตอร์

ชื่อประเภทคำอธิบาย
bodyStringเนื้อหาของอีเมล

รีเทิร์น

GmailDraft — ข้อความร่างที่สร้างขึ้นใหม่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

  • https://mail.google.com/

ดูเพิ่มเติม


createDraftReply(body, options)

สร้างข้อความร่างที่ตอบผู้ส่งข้อความสุดท้ายในชุดข้อความนี้โดยใช้ ที่อยู่สำหรับตอบกลับ พร้อมด้วยอาร์กิวเมนต์ที่เลือกระบุได้

อีเมลจะมีได้ทั้งข้อความธรรมดาและเนื้อหา HTML ขนาดของอีเมล (รวมถึง ส่วนหัว) เท่ากับโควต้า ถูกจำกัด

// Create a draft response with an HTML text body.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.createDraftReply("incapable of HTML", {
  htmlBody: "<b>some HTML body text</b>",
  cc: "another@example.com"
});

พารามิเตอร์

ชื่อประเภทคำอธิบาย
bodyStringเนื้อหาของอีเมล
optionsObjectออบเจ็กต์ JavaScript ที่ระบุพารามิเตอร์ขั้นสูง ตามที่ระบุไว้ด้านล่าง

พารามิเตอร์ขั้นสูง

ชื่อประเภทคำอธิบาย
attachmentsBlobSource[]CANNOT TRANSLATE อาร์เรย์ของไฟล์ที่จะส่งพร้อมอีเมล
bccStringรายการที่อยู่อีเมลที่คั่นด้วยเครื่องหมายจุลภาคไปยังสำเนาลับ
ccStringรายการที่อยู่อีเมลที่คั่นด้วยเครื่องหมายจุลภาคที่จะส่งสำเนาถึง
fromStringที่อยู่ที่จะใช้ส่งอีเมล ซึ่งต้อง ของค่าที่ GmailApp.getAliases() แสดงผล
htmlBodyStringหากตั้งค่าไว้ อุปกรณ์ที่แสดงภาพ HTML ได้จะใช้รูปแบบดังกล่าวแทน ของอาร์กิวเมนต์เนื้อหาที่ต้องการ คุณสามารถเพิ่มช่อง inlineImages ซึ่งไม่บังคับใน HTML เนื้อหา ถ้าคุณใส่รูปภาพในบรรทัดสำหรับอีเมล
inlineImagesObjectออบเจ็กต์ JavaScript ที่มีการแมปจากคีย์รูปภาพ (String) ไปยังข้อมูลรูปภาพ (BlobSource); ระบบจะถือว่ามีการใช้พารามิเตอร์ htmlBody และมีการอ้างอิงรูปภาพเหล่านี้ในรูปแบบ <img src="cid:imageKey" />
nameStringชื่อผู้ส่งอีเมล (ค่าเริ่มต้น: ชื่อผู้ใช้)
replyToStringที่อยู่อีเมลที่จะใช้เป็นที่อยู่ตอบกลับเริ่มต้น (ค่าเริ่มต้น: อีเมลของผู้ใช้)
subjectStringบรรทัดเรื่องใหม่สำหรับอีเมล (สูงสุด 250 อักขระ)

รีเทิร์น

GmailDraft — ข้อความร่างที่สร้างขึ้นใหม่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

  • https://mail.google.com/

ดูเพิ่มเติม


createDraftReplyAll(body)

สร้างข้อความร่างที่ตอบผู้ส่งข้อความสุดท้ายในชุดข้อความนี้ โดยใช้ ที่อยู่ตอบกลับและผู้รับทั้งหมดของข้อความนี้ ขนาดของอีเมล (รวมส่วนหัว) โควต้าจำกัด

// Create a draft reply to all recipients (except those bcc'd) of the last email in this
// thread.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.createDraftReplyAll("Got your message");

พารามิเตอร์

ชื่อประเภทคำอธิบาย
bodyStringเนื้อหาของอีเมล

รีเทิร์น

GmailDraft — ข้อความร่างที่สร้างขึ้นใหม่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

  • https://mail.google.com/

ดูเพิ่มเติม


createDraftReplyAll(body, options)

สร้างข้อความร่างที่ตอบผู้ส่งข้อความสุดท้ายในชุดข้อความนี้ โดยใช้ ที่อยู่สำหรับตอบกลับและผู้รับทั้งหมด พร้อมด้วยอาร์กิวเมนต์ที่ไม่บังคับ

อีเมลจะมีได้ทั้งข้อความธรรมดาและเนื้อหา HTML ขนาดของอีเมล (รวมถึง ส่วนหัว) เท่ากับโควต้า ถูกจำกัด

// Create a draft reply, using an HTML text body, to all recipients (except those bcc'd) of
// the last email of in this thread.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.createDraftReplyAll("incapable of HTML", {
  htmlBody: "<b>some HTML body text</b>",
  cc: "another@example.com"
});

พารามิเตอร์

ชื่อประเภทคำอธิบาย
bodyStringเนื้อหาของอีเมล
optionsObjectออบเจ็กต์ JavaScript ที่ระบุพารามิเตอร์ขั้นสูง ตามที่ระบุไว้ด้านล่าง

พารามิเตอร์ขั้นสูง

ชื่อประเภทคำอธิบาย
attachmentsBlobSource[]CANNOT TRANSLATE อาร์เรย์ของไฟล์ที่จะส่งพร้อมอีเมล
bccStringรายการที่อยู่อีเมลที่คั่นด้วยเครื่องหมายจุลภาคไปยังสำเนาลับ
ccStringรายการที่อยู่อีเมลที่คั่นด้วยเครื่องหมายจุลภาคที่จะส่งสำเนาถึง
fromStringที่อยู่ที่จะใช้ส่งอีเมล ซึ่งต้อง ของค่าที่ GmailApp.getAliases() แสดงผล
htmlBodyStringหากตั้งค่าไว้ อุปกรณ์ที่แสดงภาพ HTML ได้จะใช้รูปแบบดังกล่าวแทน ของอาร์กิวเมนต์เนื้อหาที่ต้องการ คุณสามารถเพิ่มช่อง inlineImages ซึ่งไม่บังคับใน HTML เนื้อหา ถ้าคุณใส่รูปภาพในบรรทัดสำหรับอีเมล
inlineImagesObjectออบเจ็กต์ JavaScript ที่มีการแมปจากคีย์รูปภาพ (String) ไปยังข้อมูลรูปภาพ (BlobSource); ระบบจะถือว่ามีการใช้พารามิเตอร์ htmlBody และมีการอ้างอิงรูปภาพเหล่านี้ในรูปแบบ <img src="cid:imageKey" />
nameStringชื่อผู้ส่งอีเมล (ค่าเริ่มต้น: ชื่อผู้ใช้)
replyToStringที่อยู่อีเมลที่จะใช้เป็นที่อยู่ตอบกลับเริ่มต้น (ค่าเริ่มต้น: อีเมลของผู้ใช้)
subjectStringบรรทัดเรื่องใหม่สำหรับอีเมล ขนาดสูงสุดคือ 250 อักขระ

รีเทิร์น

GmailDraft — ข้อความร่างที่สร้างขึ้นใหม่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

  • https://mail.google.com/

ดูเพิ่มเติม


getFirstMessageSubject()

รับเรื่องของข้อความแรกในชุดข้อความ

// Log the subject of the first message in the first thread in the inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log(firstThread.getFirstMessageSubject());

รีเทิร์น

String — เรื่องของข้อความแรกในชุดข้อความ

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

  • https://mail.google.com/

ดูเพิ่มเติม


getId()

รับรหัสของชุดข้อความนี้ รหัสของชุดข้อความจะแตกต่างกันไปตามข้อความที่อยู่ในชุดข้อความ สำหรับ รหัสที่สอดคล้องกันสำหรับข้อความเฉพาะในชุดข้อความ เรียกใช้ getMessages()[0].getId() แทน

// Log the subject of the first message in the first thread in the inbox.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var id = firstThread.getId();
// Get same thread by its ID.
var thread = GmailApp.getThreadById(id);
Logger.log(thread.getFirstMessageSubject() == firstThread.getFirstMessageSubject()); // True

รีเทิร์น

String — รหัสของชุดข้อความนี้


getLabels()

แสดงป้ายกำกับที่ผู้ใช้สร้างในชุดข้อความนี้

// Log the names of the labels attached to the first thread in the inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var labels = firstThread.getLabels();
for (var i = 0; i < labels.length; i++) {
  Logger.log(labels[i].getName());
}

รีเทิร์น

GmailLabel[] — อาร์เรย์ของป้ายกำกับสำหรับชุดข้อความนี้

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

  • https://mail.google.com/

getLastMessageDate()

รับข้อมูลวันที่ของข้อความล่าสุดของชุดข้อความนี้

// Log the date of the most recent message on the first thread in the inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log(firstThread.getLastMessageDate());

รีเทิร์น

Date — วันที่ของข้อความล่าสุดในชุดข้อความ

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

  • https://mail.google.com/

ดูเพิ่มเติม


getMessageCount()

แสดงผลจำนวนข้อความในชุดข้อความ

// Log the number of messages in the thread
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log(firstThread.getMessageCount());

รีเทิร์น

Integer — จำนวนข้อความในชุดข้อความ

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

  • https://mail.google.com/

ดูเพิ่มเติม


getMessages()

รับข้อความในชุดข้อความนี้

// Log the subjects of the messages in the thread
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var messages = firstThread.getMessages();
for (var i = 0; i < messages.length; i++) {
  Logger.log(messages[i].getSubject());
}

รีเทิร์น

GmailMessage[] — อาร์เรย์ของข้อความ Gmail ในชุดข้อความนี้

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

  • https://mail.google.com/

ดูเพิ่มเติม


รับลิงก์ถาวรสำหรับชุดข้อความนี้

โปรดทราบว่าการดำเนินการนี้จะใช้ได้กับอินเทอร์เฟซ Gmail แบบคลาสสิกเท่านั้น แต่จะใช้กับกล่องจดหมายไม่ได้

// Logs the permalink for the first thread in the inbox
var thread = GmailApp.getInboxThreads(0,1)[0];
Logger.log(thread.getPermalink());

รีเทิร์น

String — ลิงก์ถาวรสำหรับชุดข้อความนี้


hasStarredMessages()

แสดงผลว่าชุดข้อความมีข้อความที่ติดดาวหรือไม่

// Log if this thread has starred messages
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log('has starred : ' + firstThread.hasStarredMessages());

รีเทิร์น

Boolean — เป็นจริงหากชุดข้อความมีข้อความที่ติดดาว

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

  • https://mail.google.com/

isImportant()

แสดงผลว่ามีการทำเครื่องหมายชุดข้อความว่าสำคัญหรือไม่

// Log if this thread is marked as important
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log('Important? : ' + firstThread.isImportant());

รีเทิร์น

Boolean — ทำเครื่องหมายชุดข้อความว่าสำคัญหรือไม่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

  • https://mail.google.com/

isInChats()

แสดงผลว่าชุดข้อความมีป้ายกำกับแชทหรือไม่

// Log if this thread is a chat
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log('is in chats? : ' + firstThread.isInChats());

รีเทิร์น

Boolean — เป็นจริงหากชุดข้อความมีป้ายกำกับแชท

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

  • https://mail.google.com/

isInInbox()

แสดงผลว่าชุดข้อความอยู่ในกล่องจดหมายหรือไม่

// Log if this thread is in the inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log('is in the inbox? : ' + firstThread.isInInbox());

รีเทิร์น

Boolean — เป็นจริงหากชุดข้อความอยู่ในกล่องจดหมาย

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

  • https://mail.google.com/

isInPriorityInbox()

แสดงค่า "จริง" หากชุดข้อความนี้อยู่ในกล่องจดหมายลำดับความสำคัญ จะแสดงผลเป็น "เท็จ" หากไม่เป็นเช่นนั้น

// Log if this thread is in the priority inbox
var firstThread = GmailApp.getPriorityInboxThreads(0,1)[0];
Logger.log("is in priority inbox? " + firstThread.isInPriorityInbox());

รีเทิร์น

Boolean — เป็นจริงหากชุดข้อความอยู่ในกล่องจดหมายลำดับความสำคัญ

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

  • https://mail.google.com/

isInSpam()

แสดงผลว่ามีการทำเครื่องหมายชุดข้อความว่าเป็นสแปมหรือไม่

// Log if this thread is in the spam folder
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log('Spam? ' + firstThread.isInSpam());

รีเทิร์น

Boolean — ทำเครื่องหมายชุดข้อความนี้ว่าเป็นสแปมหรือไม่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

  • https://mail.google.com/

isInTrash()

แสดงผลว่าชุดข้อความอยู่ในถังขยะหรือไม่

// Log if this thread is in the trash
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log('Trashed? ' + firstThread.isInTrash());

รีเทิร์น

Boolean — เป็นจริงหากชุดข้อความอยู่ในถังขยะ

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

  • https://mail.google.com/

isUnread()

แสดงผลว่าชุดข้อความมีข้อความที่ยังไม่ได้อ่าน

// Log if this thread is unread
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log('Unread? ' + firstThread.isUnread());

รีเทิร์น

Boolean — เป็นจริง หากมีข้อความที่ยังไม่อ่าน

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

  • https://mail.google.com/

markImportant()

ทำเครื่องหมายชุดข้อความนี้ว่าสำคัญ

// Mark first inbox thread as important
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.markImportant();

รีเทิร์น

GmailThread — ชุดข้อความนี้มีประโยชน์สำหรับการทำสายโซ่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

  • https://mail.google.com/

ดูเพิ่มเติม


markRead()

ทำเครื่องหมายชุดข้อความนี้ว่าอ่านแล้ว

// Mark first inbox thread as read
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.markRead();

รีเทิร์น

GmailThread — ชุดข้อความนี้มีประโยชน์สำหรับการทำสายโซ่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

  • https://mail.google.com/

ดูเพิ่มเติม


markUnimportant()

ทำเครื่องหมายชุดข้อความนี้ว่าไม่สำคัญ

// Mark first inbox thread as unimportant
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.markUnimportant();

รีเทิร์น

GmailThread — ชุดข้อความนี้มีประโยชน์สำหรับการทำสายโซ่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

  • https://mail.google.com/

ดูเพิ่มเติม


markUnread()

ทำเครื่องหมายชุดข้อความนี้ว่ายังไม่อ่าน

// Mark first inbox thread as unread
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.markUnread();

รีเทิร์น

GmailThread — ชุดข้อความนี้มีประโยชน์สำหรับการทำสายโซ่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

  • https://mail.google.com/

ดูเพิ่มเติม


moveToArchive()

ย้ายชุดข้อความนี้ไปยังที่เก็บถาวร

// Archive first inbox thread
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.moveToArchive();

รีเทิร์น

GmailThread — ชุดข้อความนี้มีประโยชน์สำหรับการทำสายโซ่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

  • https://mail.google.com/

moveToInbox()

ย้ายชุดข้อความนี้ไปยังกล่องจดหมาย

// Move first non-inbox thread to inbox
var firstThread = GmailApp.search("-in:inbox")[0];
firstThread.moveToInbox();

รีเทิร์น

GmailThread — ชุดข้อความนี้มีประโยชน์สำหรับการทำสายโซ่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

  • https://mail.google.com/

moveToSpam()

ย้ายชุดข้อความนี้ไปยังโฟลเดอร์จดหมายขยะ

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

รีเทิร์น

GmailThread — ชุดข้อความนี้มีประโยชน์สำหรับการทำสายโซ่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

  • https://mail.google.com/

moveToTrash()

ย้ายชุดข้อความนี้ไปที่ถังขยะ

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

รีเทิร์น

GmailThread — ชุดข้อความนี้มีประโยชน์สำหรับการทำสายโซ่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

  • https://mail.google.com/

refresh()

โหลดชุดข้อความนี้ซ้ำและสถานะที่เกี่ยวข้องจาก Gmail (มีประโยชน์ในกรณีป้ายกำกับ สถานะการอ่าน เป็นต้น)

var firstThread = GmailApp.getInboxThreads(0,1)[0];
// ...Do something that may take a while here....
firstThread.refresh(); // Make sure it's up-to-date
// ...Do more stuff with firstThread ...

รีเทิร์น

GmailThread — ชุดข้อความนี้มีประโยชน์สำหรับการทำสายโซ่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

  • https://mail.google.com/

removeLabel(label)

นำป้ายกำกับนี้ออกจากชุดข้อความ

var myLabel = GmailApp.getUserLabelByName('<your label>');
var threads = myLabel.getThreads();
for (var x in threads) {
  var thread = threads[x];
  thread.removeLabel(myLabel);
}

พารามิเตอร์

ชื่อประเภทคำอธิบาย
labelGmailLabelป้ายกำกับที่จะนำออกจากชุดข้อความนี้

รีเทิร์น

GmailThread — ชุดข้อความนี้มีประโยชน์สำหรับการทำสายโซ่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

  • https://mail.google.com/

ดูเพิ่มเติม


reply(body)

ตอบผู้ส่งข้อความล่าสุดในชุดข้อความนี้โดยใช้อีเมลตอบกลับ

โปรดทราบว่าขนาดรวมของอีเมล (รวมส่วนหัวทั้งหมด) ต้องไม่เกิน 20 KB

// Respond to author of last email in thread with acknowledgment
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.reply("Got your message");

พารามิเตอร์

ชื่อประเภทคำอธิบาย
bodyStringเนื้อหาของอีเมล

รีเทิร์น

GmailThread — ชุดข้อความนี้มีประโยชน์สำหรับการทำสายโซ่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

  • https://mail.google.com/

ดูเพิ่มเติม


reply(body, options)

ตอบผู้ส่งข้อความล่าสุดในชุดข้อความนี้โดยใช้ที่อยู่สำหรับตอบกลับ (ไม่บังคับ) อาร์กิวเมนต์ อีเมลจะมีได้ทั้งข้อความธรรมดาและเนื้อความ HTML โปรดทราบว่ายอดรวม ขนาดของอีเมล (รวมส่วนหัวทั้งหมด แต่ไม่รวมถึงไฟล์แนบ) ต้องมีขนาดไม่เกิน 20 KB

// Respond with HTML body text.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.reply("incapable of HTML", {
  htmlBody: "some HTML body text",
  noReply: true
});

พารามิเตอร์

ชื่อประเภทคำอธิบาย
bodyStringเนื้อหาของอีเมล
optionsObjectออบเจ็กต์ JavaScript ที่ระบุพารามิเตอร์ขั้นสูง ตามที่ระบุไว้ด้านล่าง

พารามิเตอร์ขั้นสูง

ชื่อประเภทคำอธิบาย
ccStringรายการที่อยู่อีเมลที่คั่นด้วยเครื่องหมายจุลภาคที่จะส่งสำเนาถึง
bccStringรายการที่คั่นด้วยจุลภาคของที่อยู่อีเมลไปยังสำเนาลับ
htmlBodyStringหากตั้งค่าไว้ อุปกรณ์ที่แสดงภาพ HTML ได้จะใช้รูปแบบดังกล่าวแทน ของอาร์กิวเมนต์เนื้อหาที่ต้องการ คุณสามารถเพิ่มช่อง inlineImages ซึ่งไม่บังคับใน HTML เนื้อหา ถ้าคุณใส่รูปภาพในบรรทัดสำหรับอีเมล
nameStringชื่อผู้ส่งอีเมล (ค่าเริ่มต้น: ชื่อผู้ใช้)
fromStringที่อยู่ที่จะใช้ส่งอีเมล ซึ่งต้อง ของค่าที่ GmailApp.getAliases() แสดงผล
replyToStringที่อยู่อีเมลที่จะใช้เป็นที่อยู่ตอบกลับเริ่มต้น (ค่าเริ่มต้น: อีเมลของผู้ใช้)
noReplyBooleantrue หากอีเมลควรส่งจากลิงก์ทั่วไป ที่อยู่อีเมลที่ไม่มีการตอบกลับเพื่อขัดขวางไม่ให้ผู้รับตอบกลับอีเมล ตัวเลือกนี้คือ ใช้ได้เฉพาะกับบัญชี Google Workspace แต่ไม่ใช่ผู้ใช้ Gmail
attachmentsBlobSource[]CANNOT TRANSLATE อาร์เรย์ของไฟล์ที่จะส่งพร้อมอีเมล
inlineImagesObjectออบเจ็กต์ JavaScript ที่มีการแมปจากคีย์รูปภาพ (String) ไปยังข้อมูลรูปภาพ (BlobSource); ระบบจะถือว่ามีการใช้พารามิเตอร์ htmlBody และมีการอ้างอิงรูปภาพเหล่านี้ในรูปแบบ <img src="cid:imageKey" />

รีเทิร์น

GmailThread — ชุดข้อความนี้มีประโยชน์สำหรับการทำสายโซ่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

  • https://mail.google.com/

ดูเพิ่มเติม


replyAll(body)

ตอบผู้ส่ง (โดยใช้ที่อยู่สำหรับตอบกลับ) และผู้รับทั้งหมดของข้อความสุดท้ายใน ชุดข้อความ

โปรดทราบว่าขนาดรวมของอีเมล (รวมส่วนหัวทั้งหมด) ต้องไม่เกิน 20 KB

// Respond to all with acknowledgment to the first thread in the inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.replyAll("Got your message");

พารามิเตอร์

ชื่อประเภทคำอธิบาย
bodyStringเนื้อหาของอีเมล

รีเทิร์น

GmailThread — ชุดข้อความนี้มีประโยชน์สำหรับการทำสายโซ่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

  • https://mail.google.com/

ดูเพิ่มเติม


replyAll(body, options)

ตอบผู้ส่ง (โดยใช้ที่อยู่ replyTo) และผู้รับทั้งหมดของข้อความล่าสุด ในชุดข้อความนี้ พร้อมด้วยอาร์กิวเมนต์ที่ไม่บังคับ อีเมลจะมีได้ทั้งข้อความธรรมดาและ เนื้อหา HTML โปรดทราบว่าขนาดรวมของอีเมล (รวมส่วนหัวทั้งหมด แต่ไม่รวม ไฟล์แนบ) ต้องมีขนาดไม่เกิน 20 KB

// Respond with HTML body text.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.replyAll("incapable of HTML", {
  htmlBody: "some HTML body text",
  noReply: true
});

พารามิเตอร์

ชื่อประเภทคำอธิบาย
bodyStringเนื้อหาของอีเมล
optionsObjectออบเจ็กต์ JavaScript ที่ระบุพารามิเตอร์ขั้นสูง ตามที่ระบุไว้ด้านล่าง

พารามิเตอร์ขั้นสูง

ชื่อประเภทคำอธิบาย
ccStringรายการที่อยู่อีเมลที่คั่นด้วยเครื่องหมายจุลภาคที่จะส่งสำเนาถึง
bccStringรายการที่คั่นด้วยจุลภาคของที่อยู่อีเมลไปยังสำเนาลับ
htmlBodyStringหากตั้งค่าไว้ อุปกรณ์ที่แสดงภาพ HTML ได้จะใช้รูปแบบดังกล่าวแทน ของอาร์กิวเมนต์เนื้อหาที่ต้องการ คุณสามารถเพิ่มช่อง inlineImages ซึ่งไม่บังคับใน HTML เนื้อหา ถ้าคุณใส่รูปภาพในบรรทัดสำหรับอีเมล
nameStringชื่อผู้ส่งอีเมล (ค่าเริ่มต้น: ชื่อผู้ใช้)
fromStringที่อยู่ที่จะใช้ส่งอีเมล ซึ่งต้อง ของค่าที่ GmailApp.getAliases() แสดงผล
replyToStringที่อยู่อีเมลที่จะใช้เป็นที่อยู่ตอบกลับเริ่มต้น (ค่าเริ่มต้น: อีเมลของผู้ใช้)
noReplyBooleantrue หากอีเมลควรส่งจากลิงก์ทั่วไป ที่อยู่อีเมลที่ไม่มีการตอบกลับเพื่อขัดขวางไม่ให้ผู้รับตอบกลับอีเมล ตัวเลือกนี้คือ ใช้ได้เฉพาะกับบัญชี G Suite แต่ใช้กับผู้ใช้ Gmail ไม่ได้
attachmentsBlobSource[]CANNOT TRANSLATE อาร์เรย์ของไฟล์ที่จะส่งพร้อมอีเมล
inlineImagesObjectออบเจ็กต์ JavaScript ที่มีการแมปจากคีย์รูปภาพ (String) ไปยังข้อมูลรูปภาพ (BlobSource); ระบบจะถือว่ามีการใช้พารามิเตอร์ htmlBody และมีการอ้างอิงรูปภาพเหล่านี้ในรูปแบบ <img src="cid:imageKey" />

รีเทิร์น

GmailThread — ชุดข้อความนี้มีประโยชน์สำหรับการทำสายโซ่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้จำเป็นต้องได้รับการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

  • https://mail.google.com/

ดูเพิ่มเติม