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

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

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

  • https://mail.google.com/

ดูเพิ่มเติม


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

พารามิเตอร์

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

รีเทิร์น

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

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

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

  • https://mail.google.com/

ดูเพิ่มเติม


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: 'another@example.com',
});

พารามิเตอร์

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

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

ชื่อประเภทคำอธิบาย
attachmentsBlobSource[]อาร์เรย์ของไฟล์ที่จะส่งพร้อมกับอีเมล
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.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const 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.
const 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[]อาร์เรย์ของไฟล์ที่จะส่งพร้อมกับอีเมล
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
const 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.
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/

ดูเพิ่มเติม


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

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

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

ดูเพิ่มเติม


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

โปรดทราบว่าวิธีนี้ใช้ได้กับอินเทอร์เฟซ 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/

ดูเพิ่มเติม


markRead()

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

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

รีเทิร์น

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

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

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

  • https://mail.google.com/

ดูเพิ่มเติม


markUnimportant()

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

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

รีเทิร์น

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

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

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

  • https://mail.google.com/

ดูเพิ่มเติม


markUnread()

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

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

รีเทิร์น

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

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

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

  • https://mail.google.com/

ดูเพิ่มเติม


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

พารามิเตอร์

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

รีเทิร์น

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

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

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

  • https://mail.google.com/

ดูเพิ่มเติม


reply(body)

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

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

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

  • https://mail.google.com/

ดูเพิ่มเติม


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,
});

พารามิเตอร์

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

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

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

รีเทิร์น

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

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

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

  • https://mail.google.com/

ดูเพิ่มเติม


replyAll(body)

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

โปรดทราบว่าขนาดรวมของอีเมล (รวมถึงส่วนหัวทั้งหมด) ต้องไม่เกิน 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');

พารามิเตอร์

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

รีเทิร์น

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

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

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

  • https://mail.google.com/

ดูเพิ่มเติม


replyAll(body, options)

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

พารามิเตอร์

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

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

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

รีเทิร์น

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

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

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

  • https://mail.google.com/

ดูเพิ่มเติม