Class GmailThread

Gmailชุดข้อความ

เทรดในบัญชี 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	ตอบกลับผู้ส่งข้อความล่าสุดในชุดข้อความนี้โดยใช้ที่อยู่ replyTo พร้อมอาร์กิวเมนต์ที่ไม่บังคับ
replyAll(body)	GmailThread	ตอบกลับผู้ส่ง (โดยใช้อีเมลตอบกลับ) และผู้รับข้อความล่าสุดทั้งหมดในชุดข้อความนี้
replyAll(body, options)	GmailThread	ตอบกลับผู้ส่ง (โดยใช้replyTo address) และผู้รับข้อความล่าสุดทุกคนในชุดข้อความนี้พร้อมอาร์กิวเมนต์ที่ไม่บังคับ

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

addLabel(label)

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

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• removeLabel(label)

---

createDraftReply(body)

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

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• reply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body)
• createDraftReplyAll(body, options)

---

createDraftReply(body, options)

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

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

// Create a draft response with an HTML text body.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.createDraftReply('incapable of HTML', {
  htmlBody: '<b>some HTML body text</b>',
  cc: '[e-mail]',
});

พารามิเตอร์

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

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

ชื่อ	ประเภท	คำอธิบาย
attachments	BlobSource[]	อาร์เรย์ของไฟล์ที่จะส่งไปกับอีเมล
bcc	String	รายการอีเมลที่ส่งสำเนาลับซึ่งคั่นด้วยคอมมา
cc	String	รายการอีเมลที่คั่นด้วยคอมมาเพื่อส่งสำเนา
from	String	อีเมลที่ควรส่ง ซึ่งต้องเป็นค่าใดค่าหนึ่งจากค่าที่ GmailApp.getAliases() แสดง
htmlBody	String	หากตั้งค่าไว้ อุปกรณ์ที่แสดงผล HTML ได้จะใช้แทนอาร์กิวเมนต์ body ที่ต้องระบุ คุณสามารถเพิ่มช่อง inlineImages ที่ไม่บังคับในส่วนเนื้อหา HTML ได้หากมีรูปภาพที่ฝังในอีเมล
inlineImages	Object	ออบเจ็กต์ JavaScript ที่มีการแมปจากคีย์รูปภาพ (String) ไปยังข้อมูลรูปภาพ (BlobSource) โดยสมมติว่าใช้พารามิเตอร์ htmlBody และมีข้อมูลอ้างอิงรูปภาพเหล่านี้ในรูปแบบ <img src="cid:imageKey" />
name	String	ชื่อผู้ส่งอีเมล (ค่าเริ่มต้น: ชื่อผู้ใช้)
replyTo	String	อีเมลที่จะใช้เป็นอีเมลตอบกลับเริ่มต้น (ค่าเริ่มต้น: อีเมลของผู้ใช้)
subject	String	บรรทัดเรื่องใหม่สำหรับอีเมล (ไม่เกิน 250 อักขระ)

รีเทิร์น

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

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• reply(body, options)
• createDraftReply(body)
• createDraftReplyAll(body)
• createDraftReplyAll(body, options)

---

createDraftReplyAll(body)

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

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• replyAll(body)
• createDraftReply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body, options)

---

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.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.createDraftReplyAll('incapable of HTML', {
  htmlBody: '<b>some HTML body text</b>',
  cc: '[e-mail]',
});

พารามิเตอร์

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

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

ชื่อ	ประเภท	คำอธิบาย
attachments	BlobSource[]	อาร์เรย์ของไฟล์ที่จะส่งไปกับอีเมล
bcc	String	รายการอีเมลที่ส่งสำเนาลับซึ่งคั่นด้วยคอมมา
cc	String	รายการอีเมลที่คั่นด้วยคอมมาเพื่อส่งสำเนา
from	String	อีเมลที่ควรส่ง ซึ่งต้องเป็นค่าใดค่าหนึ่งจากค่าที่ GmailApp.getAliases() แสดง
htmlBody	String	หากตั้งค่าไว้ อุปกรณ์ที่แสดงผล HTML ได้จะใช้แทนอาร์กิวเมนต์ body ที่ต้องระบุ คุณสามารถเพิ่มช่อง inlineImages ที่ไม่บังคับในส่วนเนื้อหา HTML ได้หากมีรูปภาพที่ฝังในอีเมล
inlineImages	Object	ออบเจ็กต์ JavaScript ที่มีการแมปจากคีย์รูปภาพ (String) ไปยังข้อมูลรูปภาพ (BlobSource) โดยสมมติว่าใช้พารามิเตอร์ htmlBody และมีข้อมูลอ้างอิงรูปภาพเหล่านี้ในรูปแบบ <img src="cid:imageKey" />
name	String	ชื่อผู้ส่งอีเมล (ค่าเริ่มต้น: ชื่อผู้ใช้)
replyTo	String	อีเมลที่จะใช้เป็นอีเมลตอบกลับเริ่มต้น (ค่าเริ่มต้น: อีเมลของผู้ใช้)
subject	String	บรรทัดเรื่องของอีเมลใหม่ ขนาดสูงสุดคือ 250 อักขระ

รีเทิร์น

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

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• replyAll(body, options)
• createDraftReply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body)

---

getFirstMessageSubject()

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

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

รีเทิร์น

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

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• getLastMessageDate()

---

getId()

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

// Log the subject of the first message in the first thread in the inbox.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const id = firstThread.getId();
// Get same thread by its ID.
const 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
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const labels = firstThread.getLabels();
for (let 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
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(firstThread.getLastMessageDate());

รีเทิร์น

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

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• getFirstMessageSubject()

---

getMessageCount()

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

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

รีเทิร์น

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

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• getMessages()

---

getMessages()

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

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

รีเทิร์น

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

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• getMessageCount()

---

getPermalink()

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

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

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

รีเทิร์น

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

---

hasStarredMessages()

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

// Log if this thread has starred messages
const 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
const 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
const 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
const 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
const 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
const 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
const 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
const 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
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.markImportant();

รีเทิร์น

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

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• markUnimportant()

---

markRead()

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

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

รีเทิร์น

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

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• markUnread()

---

markUnimportant()

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

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

รีเทิร์น

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

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• markImportant()

---

markUnread()

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

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

รีเทิร์น

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

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• markRead()

---

moveToArchive()

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

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

รีเทิร์น

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

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

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

• https://mail.google.com/

---

moveToInbox()

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

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

รีเทิร์น

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

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

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

• https://mail.google.com/

---

moveToSpam()

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

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

รีเทิร์น

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

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

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

• https://mail.google.com/

---

moveToTrash()

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

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

รีเทิร์น

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

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

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

• https://mail.google.com/

---

refresh()

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

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

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

const myLabel = GmailApp.getUserLabelByName('<your label>');
const threads = myLabel.getThreads();
for (const thread of threads) {
  thread.removeLabel(myLabel);
}

พารามิเตอร์

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

รีเทิร์น

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

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• addLabel(label)

---

reply(body)

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

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

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• reply(body, options)
• replyAll(body)
• replyAll(body, options)

---

reply(body, options)

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

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

พารามิเตอร์

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

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

ชื่อ	ประเภท	คำอธิบาย
cc	String	รายการอีเมลที่คั่นด้วยคอมมาเพื่อส่งสำเนา
bcc	String	รายการอีเมลที่คั่นด้วยคอมมาเพื่อส่งสำเนาลับถึง
htmlBody	String	หากตั้งค่าไว้ อุปกรณ์ที่แสดงผล HTML ได้จะใช้แทนอาร์กิวเมนต์ body ที่ต้องระบุ คุณสามารถเพิ่มช่อง inlineImages ที่ไม่บังคับในส่วนเนื้อหา HTML ได้หากมีรูปภาพที่ฝังในอีเมล
name	String	ชื่อผู้ส่งอีเมล (ค่าเริ่มต้น: ชื่อผู้ใช้)
from	String	อีเมลที่ควรส่ง ซึ่งต้องเป็นค่าใดค่าหนึ่งจากค่าที่ GmailApp.getAliases() แสดง
replyTo	String	อีเมลที่จะใช้เป็นอีเมลตอบกลับเริ่มต้น (ค่าเริ่มต้น: อีเมลของผู้ใช้)
noReply	Boolean	true หากควรส่งอีเมลจากอีเมลทั่วไปที่ตอบกลับไม่ได้เพื่อไม่ให้ผู้รับตอบกลับอีเมล ตัวเลือกนี้ใช้ได้กับบัญชี Google Workspace เท่านั้น ไม่ใช่ผู้ใช้ Gmail
attachments	BlobSource[]	อาร์เรย์ของไฟล์ที่จะส่งไปกับอีเมล
inlineImages	Object	ออบเจ็กต์ JavaScript ที่มีการแมปจากคีย์รูปภาพ (String) ไปยังข้อมูลรูปภาพ (BlobSource) โดยสมมติว่าใช้พารามิเตอร์ htmlBody และมีข้อมูลอ้างอิงรูปภาพเหล่านี้ในรูปแบบ <img src="cid:imageKey" />

รีเทิร์น

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

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• reply(body)
• replyAll(body)
• replyAll(body, options)

---

replyAll(body)

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

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

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• reply(body, options)
• reply(body)
• replyAll(body, options)

---

replyAll(body, options)

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

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

พารามิเตอร์

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

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

ชื่อ	ประเภท	คำอธิบาย
cc	String	รายการอีเมลที่คั่นด้วยคอมมาเพื่อส่งสำเนา
bcc	String	รายการอีเมลที่คั่นด้วยคอมมาเพื่อส่งสำเนาลับถึง
htmlBody	String	หากตั้งค่าไว้ อุปกรณ์ที่แสดงผล HTML ได้จะใช้แทนอาร์กิวเมนต์ body ที่ต้องระบุ คุณสามารถเพิ่มช่อง inlineImages ที่ไม่บังคับในส่วนเนื้อหา HTML ได้หากมีรูปภาพที่ฝังในอีเมล
name	String	ชื่อผู้ส่งอีเมล (ค่าเริ่มต้น: ชื่อผู้ใช้)
from	String	อีเมลที่ควรส่ง ซึ่งต้องเป็นค่าใดค่าหนึ่งจากค่าที่ GmailApp.getAliases() แสดง
replyTo	String	อีเมลที่จะใช้เป็นอีเมลตอบกลับเริ่มต้น (ค่าเริ่มต้น: อีเมลของผู้ใช้)
noReply	Boolean	true หากควรส่งอีเมลจากอีเมลทั่วไปที่ตอบกลับไม่ได้เพื่อไม่ให้ผู้รับตอบกลับอีเมล ตัวเลือกนี้ใช้ได้กับบัญชี G Suite เท่านั้น ไม่ใช่ผู้ใช้ Gmail
attachments	BlobSource[]	อาร์เรย์ของไฟล์ที่จะส่งไปกับอีเมล
inlineImages	Object	ออบเจ็กต์ JavaScript ที่มีการแมปจากคีย์รูปภาพ (String) ไปยังข้อมูลรูปภาพ (BlobSource) โดยสมมติว่าใช้พารามิเตอร์ htmlBody และมีข้อมูลอ้างอิงรูปภาพเหล่านี้ในรูปแบบ <img src="cid:imageKey" />

รีเทิร์น

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

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• reply(body)
• replyAll(body)
• replyAll(body, options)