Class GmailApp

GmailApp

ให้สิทธิ์เข้าถึงชุดข้อความ ข้อความ และป้ายกำกับใน Gmail

เมธอด

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
createDraft(recipient, subject, body)	GmailDraft	สร้างข้อความอีเมลฉบับร่าง
createDraft(recipient, subject, body, options)	GmailDraft	สร้างข้อความอีเมลฉบับร่างที่มีอาร์กิวเมนต์ซึ่งไม่บังคับ
createLabel(name)	GmailLabel	สร้างป้ายกำกับผู้ใช้ใหม่ตามชื่อที่ระบุ
deleteLabel(label)	GmailApp	ลบป้ายกำกับที่ระบุ
getAliases()	String[]	รับรายการอีเมลที่ตั้งค่าเป็นชื่อแทนสำหรับบัญชีนี้ใน Gmail
getDraft(draftId)	GmailDraft	เรียกดูข้อความอีเมลฉบับร่างตามรหัส
getDraftMessages()	GmailMessage[]	เรียกข้อความร่างทั้งหมด
getDrafts()	GmailDraft[]	รับข้อความฉบับร่างของ Gmail ทั้งหมด
getInboxThreads()	GmailThread[]	ดึงข้อมูลชุดข้อความกล่องจดหมายทั้งหมดโดยไม่คำนึงถึงป้ายกำกับ
getInboxThreads(start, max)	GmailThread[]	เรียกข้อมูลกลุ่มชุดข้อความกล่องจดหมายโดยไม่คำนึงถึงป้ายกำกับ
getInboxUnreadCount()	Integer	รับจำนวนชุดข้อความที่ยังไม่อ่านในกล่องจดหมาย
getMessageById(id)	GmailMessage	รับข้อความโดยใช้รหัส
getMessagesForThread(thread)	GmailMessage[]	เรียกดูข้อความทั้งหมดในชุดข้อความที่ระบุ
getMessagesForThreads(threads)	GmailMessage[][]	เรียกดูข้อความทั้งหมดในชุดข้อความที่ระบุ
getPriorityInboxThreads()	GmailThread[]	ดึงข้อมูลชุดข้อความของกล่องจดหมายสำคัญทั้งหมด โดยไม่คำนึงถึงป้ายกำกับ
getPriorityInboxThreads(start, max)	GmailThread[]	เรียกดูกลุ่มชุดข้อความของกล่องจดหมายสำคัญโดยไม่คำนึงถึงป้ายกำกับ
getPriorityInboxUnreadCount()	Integer	รับจำนวนชุดข้อความที่ยังไม่อ่านในกล่องจดหมายสำคัญ
getSpamThreads()	GmailThread[]	ดึงข้อมูลชุดข้อความสแปมทั้งหมดโดยไม่คำนึงถึงป้ายกำกับ
getSpamThreads(start, max)	GmailThread[]	ดึงข้อมูลกลุ่มชุดข้อความสแปมโดยไม่คำนึงถึงป้ายกำกับ
getSpamUnreadCount()	Integer	รับจำนวนชุดข้อความที่ยังไม่อ่านซึ่งเป็นสแปม
getStarredThreads()	GmailThread[]	เรียกข้อมูลชุดข้อความที่ติดดาวทั้งหมดโดยไม่คำนึงถึงป้ายกำกับ
getStarredThreads(start, max)	GmailThread[]	ดึงข้อมูลช่วงของชุดข้อความที่ติดดาวโดยไม่คำนึงถึงป้ายกำกับ
getStarredUnreadCount()	Integer	รับจำนวนชุดข้อความที่ยังไม่อ่านซึ่งติดดาว
getThreadById(id)	GmailThread	รับชุดข้อความตามรหัส
getTrashThreads()	GmailThread[]	ดึงข้อมูลชุดข้อความทั้งหมดในถังขยะโดยไม่คำนึงถึงป้ายกำกับ
getTrashThreads(start, max)	GmailThread[]	ดึงข้อมูลกลุ่มชุดข้อความในถังขยะโดยไม่คำนึงถึงป้ายกำกับ
getUserLabelByName(name)	GmailLabel	ดึงข้อมูลป้ายกำกับที่มีชื่อป้ายกำกับ
getUserLabels()	GmailLabel[]	เรียกข้อมูลรายการป้ายกำกับที่ผู้ใช้สร้างขึ้น
markMessageRead(message)	GmailApp	ทำเครื่องหมายว่าข้อความนี้อ่านแล้วและบังคับให้รีเฟรชข้อความ
markMessageUnread(message)	GmailApp	ทำเครื่องหมายข้อความนี้ว่ายังไม่อ่านและบังคับให้รีเฟรชข้อความ
markMessagesRead(messages)	GmailApp	ทำเครื่องหมายว่าข้อความเหล่านี้อ่านแล้วและบังคับให้รีเฟรชข้อความ
markMessagesUnread(messages)	GmailApp	ทำเครื่องหมายข้อความเหล่านี้ว่ายังไม่อ่านและบังคับให้รีเฟรชข้อความ
markThreadImportant(thread)	GmailApp	ทำเครื่องหมายชุดข้อความนี้ว่าสำคัญและบังคับให้รีเฟรชชุดข้อความ
markThreadRead(thread)	GmailApp	ทำเครื่องหมายชุดข้อความว่าอ่านแล้วและบังคับให้รีเฟรชชุดข้อความ
markThreadUnimportant(thread)	GmailApp	ทำเครื่องหมายชุดข้อความนี้ว่าไม่สำคัญและบังคับให้รีเฟรชชุดข้อความ
markThreadUnread(thread)	GmailApp	ทำเครื่องหมายว่าชุดข้อความนี้ยังไม่อ่าน และบังคับให้รีเฟรชชุดข้อความ
markThreadsImportant(threads)	GmailApp	ทำเครื่องหมายชุดข้อความเหล่านี้ว่าสำคัญและบังคับให้รีเฟรชชุดข้อความ
markThreadsRead(threads)	GmailApp	ทำเครื่องหมายชุดข้อความเหล่านี้ว่าอ่านแล้วและบังคับให้รีเฟรชชุดข้อความ
markThreadsUnimportant(threads)	GmailApp	ทำเครื่องหมายชุดข้อความเหล่านี้ว่าไม่สำคัญและบังคับให้รีเฟรชชุดข้อความ
markThreadsUnread(threads)	GmailApp	ทำเครื่องหมายชุดข้อความเหล่านี้ว่ายังไม่อ่านและบังคับให้รีเฟรชชุดข้อความ
moveMessageToTrash(message)	GmailApp	ย้ายข้อความไปยังถังขยะและบังคับให้รีเฟรชข้อความ
moveMessagesToTrash(messages)	GmailApp	ย้ายข้อความที่ระบุไปยังถังขยะและบังคับให้รีเฟรชข้อความ
moveThreadToArchive(thread)	GmailApp	ย้ายชุดข้อความนี้ไปยังที่เก็บถาวรและบังคับให้รีเฟรชชุดข้อความ
moveThreadToInbox(thread)	GmailApp	ย้ายชุดข้อความนี้ไปยังกล่องจดหมายและบังคับให้รีเฟรชชุดข้อความ
moveThreadToSpam(thread)	GmailApp	ย้ายชุดข้อความนี้ไปยังสแปมและบังคับให้รีเฟรชชุดข้อความ
moveThreadToTrash(thread)	GmailApp	ย้ายชุดข้อความนี้ไปที่ถังขยะและบังคับให้รีเฟรชชุดข้อความ
moveThreadsToArchive(threads)	GmailApp	ย้ายชุดข้อความเหล่านี้ไปยังที่เก็บถาวรและบังคับให้รีเฟรชชุดข้อความ
moveThreadsToInbox(threads)	GmailApp	ย้ายชุดข้อความเหล่านี้ไปยังกล่องจดหมายและบังคับให้รีเฟรชชุดข้อความ
moveThreadsToSpam(threads)	GmailApp	ย้ายชุดข้อความเหล่านี้ไปยังสแปมและบังคับให้รีเฟรชชุดข้อความ
moveThreadsToTrash(threads)	GmailApp	ย้ายชุดข้อความเหล่านี้ไปที่ถังขยะและบังคับให้รีเฟรชชุดข้อความ
refreshMessage(message)	GmailApp	โหลดข้อความและสถานะที่เกี่ยวข้องจาก Gmail ซ้ำ (มีประโยชน์ในกรณีป้ายกำกับ สถานะการอ่าน เป็นต้น)
refreshMessages(messages)	GmailApp	โหลดข้อความและสถานะที่เกี่ยวข้องจาก Gmail ซ้ำ (มีประโยชน์ในกรณีป้ายกำกับ สถานะการอ่าน เป็นต้น)
refreshThread(thread)	GmailApp	โหลดชุดข้อความและสถานะที่เกี่ยวข้องจาก Gmail ซ้ำ (มีประโยชน์ในกรณีป้ายกำกับ สถานะการอ่าน เป็นต้น)
refreshThreads(threads)	GmailApp	โหลดชุดข้อความและสถานะที่เกี่ยวข้องจาก Gmail ซ้ำ (มีประโยชน์ในกรณีป้ายกำกับ สถานะการอ่าน เป็นต้น)
search(query)	GmailThread[]	ค้นหาใน Gmail ด้วยคำค้นหาที่ระบุ
search(query, start, max)	GmailThread[]	ค้นหาใน Gmail ด้วยคำค้นหาที่ระบุ
sendEmail(recipient, subject, body)	GmailApp	ส่งข้อความอีเมล
sendEmail(recipient, subject, body, options)	GmailApp	ส่งข้อความอีเมลพร้อมอาร์กิวเมนต์ที่ไม่บังคับ
setCurrentMessageAccessToken(accessToken)	void	ตั้งค่าข้อความปัจจุบัน โทเค็นเพื่อการเข้าถึงที่ช่วยให้สคริปต์เข้าถึงพร็อพเพอร์ตี้ GmailMessage ปัจจุบันได้
starMessage(message)	GmailApp	ติดดาวให้ข้อความนี้และบังคับให้รีเฟรชข้อความ
starMessages(messages)	GmailApp	ติดดาวข้อความเหล่านี้และบังคับให้รีเฟรชข้อความ
unstarMessage(message)	GmailApp	นำดาวออกจากข้อความนี้และบังคับให้รีเฟรชข้อความ
unstarMessages(messages)	GmailApp	นำดาวออกจากข้อความเหล่านี้และบังคับให้รีเฟรชข้อความ

วิธีการที่เลิกใช้งานแล้ว

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
getChatThreads()	GmailThread[]	รับชุดข้อความ Google Hangouts แบบคลาสสิกและชุดข้อความ Google Chat ทั้งหมดจนกว่า Google จะเปลี่ยนทั้งหมด ผู้ใช้ Hangouts แบบคลาสสิกไปยัง Chat ภายในปีนี้
getChatThreads(start, max)	GmailThread[]	รับชุดข้อความ Google Hangouts แบบคลาสสิกและชุดข้อความ Google Chat ที่หลากหลายจนกว่า Google จะเปลี่ยน ผู้ใช้ทั้งหมดของ Hangouts แบบคลาสสิกไปยัง Chat ภายในปีนี้

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

createDraft(recipient, subject, body)

สร้างข้อความอีเมลฉบับร่าง ขนาดของอีเมล (รวมส่วนหัว) จะมีโควต้าจำกัด

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
recipient	String	รายการที่อยู่อีเมลที่คั่นด้วยคอมมา
subject	String	เรื่องของอีเมล
body	String	เนื้อหาของอีเมล

รีเทิร์น

GmailDraft — Gmail ร่างจดหมายที่สร้างขึ้นใหม่

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• createDraft(recipient, subject, body, options)

---

createDraft(recipient, subject, body, options)

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

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

พารามิเตอร์

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

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

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

รีเทิร์น

GmailDraft — Gmail ร่างจดหมายที่สร้างขึ้นใหม่

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• createDraft(recipient, subject, body)

---

createLabel(name)

สร้างป้ายกำกับผู้ใช้ใหม่ตามชื่อที่ระบุ

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
name	String	ชื่อป้ายกำกับใหม่

รีเทิร์น

GmailLabel — ป้ายกำกับที่สร้างขึ้นใหม่

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• deleteLabel(label)

---

deleteLabel(label)

ลบป้ายกำกับที่ระบุ

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
label	GmailLabel	ป้ายกำกับที่จะลบ

รีเทิร์น

GmailApp — บริการ Gmail มีประโยชน์สำหรับการทำห่วงโซ่

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• createLabel(name)

---

getAliases()

รับรายการอีเมลที่ตั้งค่าเป็นชื่อแทนสำหรับบัญชีนี้ใน Gmail

คุณสามารถส่งข้อความจากชื่อแทนเหล่านี้โดยใช้ "จาก" อาร์กิวเมนต์ที่ไม่บังคับ

// 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.');
}

รีเทิร์น

String[] — อาร์เรย์ของชื่อแทนสำหรับบัญชีนี้

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• sendEmail(recipient, subject, body, options)

---

getDraft(draftId)

เรียกดูข้อความอีเมลฉบับร่างตามรหัส

ใช้ร่วมกับ getId() ในฉบับร่างของ 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());

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
draftId	String	รหัสของฉบับร่างที่จะดึงข้อมูล

รีเทิร์น

GmailDraft — ข้อความร่างที่มีรหัสที่ระบุ

การขว้าง

Error — หากไม่พบข้อความร่างที่มีรหัสที่ระบุ

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

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

• https://mail.google.com/

---

getDraftMessages()

เรียกข้อความร่างทั้งหมด

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

รีเทิร์น

GmailMessage[] — อาร์เรย์ของข้อความ Gmail ฉบับร่าง

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

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

• https://mail.google.com/

---

getDrafts()

รับข้อความฉบับร่างของ Gmail ทั้งหมด

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

รีเทิร์น

GmailDraft[] — ชุดข้อความฉบับร่างของ Gmail

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

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

• https://mail.google.com/

---

getInboxThreads()

ดึงข้อมูลชุดข้อความกล่องจดหมายทั้งหมดโดยไม่คำนึงถึงป้ายกำกับ

การเรียกใช้นี้จะล้มเหลวเมื่อเทรดทั้งหมดมีขนาดใหญ่เกินกว่าที่ระบบจะจัดการได้ ในกรณีที่ไม่ทราบขนาดชุดข้อความและอาจมีขนาดใหญ่มาก โปรดใช้ลิงก์ "แบ่งหน้า" และ ระบุช่วงของชุดข้อความที่จะดึงข้อมูลในการเรียกใช้แต่ละครั้ง

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

รีเทิร์น

GmailThread[] — อาร์เรย์ของชุดข้อความ Gmail ในกล่องจดหมาย

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

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

• https://mail.google.com/

---

getInboxThreads(start, max)

เรียกข้อมูลกลุ่มชุดข้อความกล่องจดหมายโดยไม่คำนึงถึงป้ายกำกับ

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
start	Integer	ดัชนีของชุดข้อความแรกที่ดึงข้อมูล
max	Integer	จำนวนเทรดสูงสุดที่จะดึงข้อมูล

รีเทิร์น

GmailThread[] — อาร์เรย์ของชุดข้อความ Gmail ในกล่องจดหมาย

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

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

• https://mail.google.com/

---

getInboxUnreadCount()

รับจำนวนชุดข้อความที่ยังไม่อ่านในกล่องจดหมาย

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

รีเทิร์น

Integer — จำนวนชุดข้อความในกล่องจดหมายที่มีข้อความที่ยังไม่อ่าน

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

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

• https://mail.google.com/

---

getMessageById(id)

รับข้อความโดยใช้รหัส

ใช้ร่วมกับ getId() ในข้อความ 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());

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
id	String	รหัสของข้อความที่จะดึง

รีเทิร์น

GmailMessage — ข้อความที่มีรหัสที่ระบุ

การขว้าง

Error — หากไม่พบข้อความที่มีรหัสที่ระบุ

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• getThreadById(id)

---

getMessagesForThread(thread)

เรียกดูข้อความทั้งหมดในชุดข้อความที่ระบุ

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

พารามิเตอร์

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

รีเทิร์น

GmailMessage[] — อาร์เรย์ของข้อความที่เกี่ยวข้องกับชุดข้อความนี้

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• getMessagesForThreads(threads)

---

getMessagesForThreads(threads)

เรียกดูข้อความทั้งหมดในชุดข้อความที่ระบุ

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
threads	GmailThread[]	ชุดข้อความที่จะดึงมา

รีเทิร์น

GmailMessage[][] — อาร์เรย์ของข้อความ โดยแต่ละรายการในอาร์เรย์ภายนอกจะสอดคล้องกับ ชุดข้อความและอาร์เรย์ภายในมีข้อความในชุดข้อความนั้น

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• getMessagesForThread(thread)

---

getPriorityInboxThreads()

ดึงข้อมูลชุดข้อความของกล่องจดหมายสำคัญทั้งหมด โดยไม่คำนึงถึงป้ายกำกับ

การเรียกใช้นี้จะล้มเหลวเมื่อเทรดทั้งหมดมีขนาดใหญ่เกินกว่าที่ระบบจะจัดการได้ ในกรณีที่ไม่ทราบขนาดชุดข้อความและอาจมีขนาดใหญ่มาก โปรดใช้ลิงก์ "แบ่งหน้า" และ ระบุช่วงของชุดข้อความที่จะดึงข้อมูลในการเรียกใช้แต่ละครั้ง

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

รีเทิร์น

GmailThread[] — อาร์เรย์ของชุดข้อความ Gmail ในกล่องจดหมายสำคัญ

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

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

• https://mail.google.com/

---

getPriorityInboxThreads(start, max)

เรียกดูกลุ่มชุดข้อความของกล่องจดหมายสำคัญโดยไม่คำนึงถึงป้ายกำกับ

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
start	Integer	ดัชนีของชุดข้อความแรกที่ดึงข้อมูล
max	Integer	จำนวนเทรดสูงสุดที่จะดึงข้อมูล

รีเทิร์น

GmailThread[] — อาร์เรย์ของชุดข้อความ Gmail ในกล่องจดหมายสำคัญ

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

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

• https://mail.google.com/

---

getPriorityInboxUnreadCount()

รับจำนวนชุดข้อความที่ยังไม่อ่านในกล่องจดหมายสำคัญ

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

รีเทิร์น

Integer — จำนวนชุดข้อความในกล่องจดหมายสำคัญที่มีข้อความที่ยังไม่อ่าน

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

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

• https://mail.google.com/

---

getSpamThreads()

ดึงข้อมูลชุดข้อความสแปมทั้งหมดโดยไม่คำนึงถึงป้ายกำกับ

การเรียกใช้นี้จะล้มเหลวเมื่อเทรดทั้งหมดมีขนาดใหญ่เกินกว่าที่ระบบจะจัดการได้ ในกรณีที่ไม่ทราบขนาดชุดข้อความและอาจมีขนาดใหญ่มาก โปรดใช้ลิงก์ "แบ่งหน้า" และ ระบุช่วงของชุดข้อความที่จะดึงข้อมูลในการเรียกใช้แต่ละครั้ง

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

รีเทิร์น

GmailThread[] — ชุดข้อความของ Gmail จำนวนมากในโฟลเดอร์จดหมายขยะ

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

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

• https://mail.google.com/

---

getSpamThreads(start, max)

ดึงข้อมูลกลุ่มชุดข้อความสแปมโดยไม่คำนึงถึงป้ายกำกับ

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
start	Integer	ดัชนีของชุดข้อความแรกที่ดึงข้อมูล
max	Integer	จำนวนเทรดสูงสุดที่จะดึงข้อมูล

รีเทิร์น

GmailThread[] — ชุดข้อความของ Gmail จำนวนมากในโฟลเดอร์จดหมายขยะ

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

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

• https://mail.google.com/

---

getSpamUnreadCount()

รับจำนวนชุดข้อความที่ยังไม่อ่านซึ่งเป็นสแปม

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

รีเทิร์น

Integer — จำนวนชุดข้อความสแปมที่มีข้อความที่ยังไม่อ่าน

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

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

• https://mail.google.com/

---

getStarredThreads()

เรียกข้อมูลชุดข้อความที่ติดดาวทั้งหมดโดยไม่คำนึงถึงป้ายกำกับ

การเรียกใช้นี้จะล้มเหลวเมื่อเทรดทั้งหมดมีขนาดใหญ่เกินกว่าที่ระบบจะจัดการได้ ในกรณีที่ไม่ทราบขนาดชุดข้อความและอาจมีขนาดใหญ่มาก โปรดใช้ลิงก์ "แบ่งหน้า" และ ระบุช่วงของชุดข้อความที่จะดึงข้อมูลในการเรียกใช้แต่ละครั้ง

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

รีเทิร์น

GmailThread[] — ชุดข้อความ Gmail ที่ติดดาว

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

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

• https://mail.google.com/

---

getStarredThreads(start, max)

ดึงข้อมูลช่วงของชุดข้อความที่ติดดาวโดยไม่คำนึงถึงป้ายกำกับ

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
start	Integer	ดัชนีของชุดข้อความแรกที่ดึงข้อมูล
max	Integer	จำนวนเทรดสูงสุดที่จะดึงข้อมูล

รีเทิร์น

GmailThread[] — ชุดข้อความ Gmail ที่ติดดาว

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

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

• https://mail.google.com/

---

getStarredUnreadCount()

รับจำนวนชุดข้อความที่ยังไม่อ่านซึ่งติดดาว

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

รีเทิร์น

Integer — จำนวนชุดข้อความที่ติดดาวซึ่งมีข้อความที่ยังไม่อ่าน

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

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

• https://mail.google.com/

---

getThreadById(id)

รับชุดข้อความตามรหัส

ใช้ร่วมกับ getId() ในชุดข้อความ Gmail

// Gets the first inbox thread.
const firstThread = GmailApp.getInboxThreads(0,1)[0];
// Gets the same thread by ID.
const threadById = GmailApp.getThreadById(firstThread.getId());
// Verifies that they are the same.
console.log(firstThread.getFirstMessageSubject() === threadById.getFirstMessageSubject());

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
id	String	รหัสของชุดข้อความที่จะดึงข้อมูล

รีเทิร์น

GmailThread — ชุดข้อความที่มีรหัสที่ระบุหรือ null หากไม่พบ

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• getMessageById(id)

---

getTrashThreads()

ดึงข้อมูลชุดข้อความทั้งหมดในถังขยะโดยไม่คำนึงถึงป้ายกำกับ

การเรียกใช้นี้จะล้มเหลวเมื่อเทรดทั้งหมดมีขนาดใหญ่เกินกว่าที่ระบบจะจัดการได้ ในกรณีที่ไม่ทราบขนาดชุดข้อความและอาจมีขนาดใหญ่มาก โปรดใช้ลิงก์ "แบ่งหน้า" และ ระบุช่วงของชุดข้อความที่จะดึงข้อมูลในการเรียกใช้แต่ละครั้ง

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

รีเทิร์น

GmailThread[] — อาร์เรย์ของชุดข้อความ Gmail ในถังขยะ

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

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

• https://mail.google.com/

---

getTrashThreads(start, max)

ดึงข้อมูลกลุ่มชุดข้อความในถังขยะโดยไม่คำนึงถึงป้ายกำกับ

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
start	Integer	ดัชนีของชุดข้อความแรกที่ดึงข้อมูล
max	Integer	จำนวนเทรดสูงสุดที่จะดึงข้อมูล

รีเทิร์น

GmailThread[] — อาร์เรย์ของชุดข้อความ Gmail ในถังขยะ

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

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

• https://mail.google.com/

---

getUserLabelByName(name)

ดึงข้อมูลป้ายกำกับที่มีชื่อป้ายกำกับ

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
name	String	ชื่อของป้ายกำกับที่จะดึงข้อมูล

รีเทิร์น

GmailLabel — ป้ายกำกับ Gmail ตามชื่อตัว

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

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

• https://mail.google.com/

---

getUserLabels()

เรียกข้อมูลรายการป้ายกำกับที่ผู้ใช้สร้างขึ้น

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

รีเทิร์น

GmailLabel[] — อาร์เรย์ของป้ายกำกับที่ผู้ใช้สร้าง

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

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

• https://mail.google.com/

---

markMessageRead(message)

ทำเครื่องหมายว่าข้อความนี้อ่านแล้วและบังคับให้รีเฟรชข้อความ

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
message	GmailMessage	ข้อความเพื่อทำเครื่องหมายว่าอ่านแล้ว

รีเทิร์น

GmailApp — บริการ Gmail มีประโยชน์สำหรับการทำห่วงโซ่

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• markMessageUnread(message)

---

markMessageUnread(message)

ทำเครื่องหมายข้อความนี้ว่ายังไม่อ่านและบังคับให้รีเฟรชข้อความ

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
message	GmailMessage	ข้อความเพื่อทำเครื่องหมายว่ายังไม่อ่าน

รีเทิร์น

GmailApp — บริการ Gmail มีประโยชน์สำหรับการทำห่วงโซ่

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• markMessageRead(message)

---

markMessagesRead(messages)

ทำเครื่องหมายว่าข้อความเหล่านี้อ่านแล้วและบังคับให้รีเฟรชข้อความ

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
messages	GmailMessage[]	อาร์เรย์ข้อความที่จะทำเครื่องหมายว่าอ่านแล้ว

รีเทิร์น

GmailApp — บริการ Gmail มีประโยชน์สำหรับการทำห่วงโซ่

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• markMessagesUnread(messages)

---

markMessagesUnread(messages)

ทำเครื่องหมายข้อความเหล่านี้ว่ายังไม่อ่านและบังคับให้รีเฟรชข้อความ

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
messages	GmailMessage[]	อาร์เรย์ข้อความที่จะทำเครื่องหมายว่ายังไม่อ่าน

รีเทิร์น

GmailApp — บริการ Gmail มีประโยชน์สำหรับการทำห่วงโซ่

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• markMessagesRead(messages)

---

markThreadImportant(thread)

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
thread	GmailThread	ชุดข้อความเพื่อทำเครื่องหมายว่าสำคัญ

รีเทิร์น

GmailApp — บริการ Gmail มีประโยชน์สำหรับการทำห่วงโซ่

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• markThreadUnimportant(thread)

---

markThreadRead(thread)

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
thread	GmailThread	ชุดข้อความเพื่อทำเครื่องหมายว่าอ่านแล้ว

รีเทิร์น

GmailApp — บริการ Gmail มีประโยชน์สำหรับการทำห่วงโซ่

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• markThreadUnread(thread)

---

markThreadUnimportant(thread)

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
thread	GmailThread	ชุดข้อความเพื่อทำเครื่องหมายว่าไม่สำคัญ

รีเทิร์น

GmailApp — บริการ Gmail มีประโยชน์สำหรับการทำห่วงโซ่

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• markThreadImportant(thread)

---

markThreadUnread(thread)

ทำเครื่องหมายว่าชุดข้อความนี้ยังไม่อ่าน และบังคับให้รีเฟรชชุดข้อความ

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
thread	GmailThread	ชุดข้อความเพื่อทำเครื่องหมายว่ายังไม่อ่าน

รีเทิร์น

GmailApp — บริการ Gmail มีประโยชน์สำหรับการทำห่วงโซ่

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• markThreadRead(thread)

---

markThreadsImportant(threads)

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
threads	GmailThread[]	อาร์เรย์ของชุดข้อความที่จะทำเครื่องหมายว่าสำคัญ

รีเทิร์น

GmailApp — บริการ Gmail มีประโยชน์สำหรับการทำห่วงโซ่

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• markThreadsUnimportant(threads)

---

markThreadsRead(threads)

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
threads	GmailThread[]	อาร์เรย์ของชุดข้อความที่จะทำเครื่องหมายว่าอ่านแล้ว

รีเทิร์น

GmailApp — บริการ Gmail มีประโยชน์สำหรับการทำห่วงโซ่

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• markThreadsUnread(threads)

---

markThreadsUnimportant(threads)

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
threads	GmailThread[]	อาร์เรย์ของชุดข้อความที่จะทำเครื่องหมายว่าไม่สำคัญ

รีเทิร์น

GmailApp — บริการ Gmail มีประโยชน์สำหรับการทำห่วงโซ่

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• markThreadsImportant(threads)

---

markThreadsUnread(threads)

ทำเครื่องหมายชุดข้อความเหล่านี้ว่ายังไม่อ่านและบังคับให้รีเฟรชชุดข้อความ

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
threads	GmailThread[]	อาร์เรย์ของชุดข้อความที่จะทําเครื่องหมายว่ายังไม่อ่าน

รีเทิร์น

GmailApp — บริการ Gmail มีประโยชน์สำหรับการทำห่วงโซ่

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• markThreadsRead(threads)

---

moveMessageToTrash(message)

ย้ายข้อความไปยังถังขยะและบังคับให้รีเฟรชข้อความ

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
message	GmailMessage	ข้อความที่จะทิ้ง

รีเทิร์น

GmailApp — บริการ Gmail (มีประโยชน์สำหรับการทำเชน)

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• moveMessagesToTrash(messages)

---

moveMessagesToTrash(messages)

ย้ายข้อความที่ระบุไปยังถังขยะและบังคับให้รีเฟรชข้อความ

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
messages	GmailMessage[]	ข้อความที่จะทิ้ง

รีเทิร์น

GmailApp — บริการ Gmail (มีประโยชน์สำหรับการทำเชน)

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• moveMessageToTrash(message)

---

moveThreadToArchive(thread)

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
thread	GmailThread	ชุดข้อความที่จะเก็บถาวร

รีเทิร์น

GmailApp — บริการ Gmail มีประโยชน์สำหรับการทำห่วงโซ่

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

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

• https://mail.google.com/

ดูเพิ่มเติม

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

---

moveThreadToInbox(thread)

ย้ายชุดข้อความนี้ไปยังกล่องจดหมายและบังคับให้รีเฟรชชุดข้อความ

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
thread	GmailThread	ชุดข้อความที่จะย้ายไปที่กล่องจดหมาย

รีเทิร์น

GmailApp — บริการ Gmail มีประโยชน์สำหรับการทำห่วงโซ่

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

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

• https://mail.google.com/

ดูเพิ่มเติม

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

---

moveThreadToSpam(thread)

ย้ายชุดข้อความนี้ไปยังสแปมและบังคับให้รีเฟรชชุดข้อความ

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
thread	GmailThread	ชุดข้อความที่จะย้ายไปยังโฟลเดอร์จดหมายขยะ

รีเทิร์น

GmailApp — บริการ Gmail มีประโยชน์สำหรับการทำห่วงโซ่

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

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

• https://mail.google.com/

ดูเพิ่มเติม

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

---

moveThreadToTrash(thread)

ย้ายชุดข้อความนี้ไปที่ถังขยะและบังคับให้รีเฟรชชุดข้อความ

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
thread	GmailThread	ชุดข้อความที่จะทิ้ง

รีเทิร์น

GmailApp — บริการ Gmail มีประโยชน์สำหรับการทำห่วงโซ่

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

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

• https://mail.google.com/

ดูเพิ่มเติม

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

---

moveThreadsToArchive(threads)

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
threads	GmailThread[]	อาร์เรย์ของชุดข้อความที่จะเก็บถาวร

รีเทิร์น

GmailApp — บริการ Gmail มีประโยชน์สำหรับการทำห่วงโซ่

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

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

• https://mail.google.com/

ดูเพิ่มเติม

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

---

moveThreadsToInbox(threads)

ย้ายชุดข้อความเหล่านี้ไปยังกล่องจดหมายและบังคับให้รีเฟรชชุดข้อความ

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
threads	GmailThread[]	อาร์เรย์ของชุดข้อความที่จะส่งไปยังกล่องจดหมาย

รีเทิร์น

GmailApp — บริการ Gmail มีประโยชน์สำหรับการทำห่วงโซ่

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

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

• https://mail.google.com/

ดูเพิ่มเติม

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

---

moveThreadsToSpam(threads)

ย้ายชุดข้อความเหล่านี้ไปยังสแปมและบังคับให้รีเฟรชชุดข้อความ

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
threads	GmailThread[]	อาร์เรย์ของชุดข้อความที่จะถูกย้ายไปยังสแปม

รีเทิร์น

GmailApp — บริการ Gmail มีประโยชน์สำหรับการทำห่วงโซ่

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

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

• https://mail.google.com/

ดูเพิ่มเติม

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

---

moveThreadsToTrash(threads)

ย้ายชุดข้อความเหล่านี้ไปที่ถังขยะและบังคับให้รีเฟรชชุดข้อความ

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
threads	GmailThread[]	อาร์เรย์ของชุดข้อความที่จะทิ้ง

รีเทิร์น

GmailApp — บริการ Gmail มีประโยชน์สำหรับการทำห่วงโซ่

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

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

• https://mail.google.com/

ดูเพิ่มเติม

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

---

refreshMessage(message)

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
message	GmailMessage	ข้อความที่จะรีเฟรช

รีเทิร์น

GmailApp — บริการ Gmail มีประโยชน์สำหรับการทำห่วงโซ่

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• refreshMessages(messages)

---

refreshMessages(messages)

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
messages	GmailMessage[]	ข้อความที่จะรีเฟรช

รีเทิร์น

GmailApp — บริการ Gmail มีประโยชน์สำหรับการทำห่วงโซ่

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• refreshMessage(message)

---

refreshThread(thread)

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
thread	GmailThread	ชุดข้อความที่จะรีเฟรช

รีเทิร์น

GmailApp — บริการ Gmail มีประโยชน์สำหรับการทำห่วงโซ่

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• refreshThreads(threads)

---

refreshThreads(threads)

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
threads	GmailThread[]	ชุดข้อความที่จะรีเฟรช

รีเทิร์น

GmailApp — บริการ Gmail มีประโยชน์สำหรับการทำห่วงโซ่

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• refreshThread(thread)

---

search(query)

ค้นหาใน Gmail ด้วยคำค้นหาที่ระบุ

การเรียกใช้นี้จะล้มเหลวเมื่อเทรดทั้งหมดมีขนาดใหญ่เกินกว่าที่ระบบจะจัดการได้ ในกรณีที่ไม่ทราบขนาดชุดข้อความและอาจมีขนาดใหญ่มาก โปรดใช้ลิงก์ "แบ่งหน้า" และ ระบุช่วงของชุดข้อความที่จะดึงข้อมูลในการเรียกใช้แต่ละครั้ง

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
query	String	คำค้นหา เหมือนที่คุณพิมพ์ลงใน Gmail

รีเทิร์น

GmailThread[] — อาร์เรย์ของชุดข้อความ Gmail ที่ตรงกับการค้นหานี้

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

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

• https://mail.google.com/

---

search(query, start, max)

ค้นหาใน Gmail ด้วยคำค้นหาที่ระบุ

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
query	String	คำค้นหา เหมือนที่คุณพิมพ์ลงใน Gmail
start	Integer	ดัชนีของชุดข้อความเริ่มต้น
max	Integer	จำนวนเทรดสูงสุดที่จะแสดง

รีเทิร์น

GmailThread[] — อาร์เรย์ของชุดข้อความ Gmail ที่ตรงกับการค้นหานี้

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

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

• https://mail.google.com/

---

sendEmail(recipient, subject, body)

ส่งข้อความอีเมล ขนาดของอีเมล (รวมส่วนหัว) จะมีโควต้าจำกัด

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
recipient	String	รายการที่อยู่อีเมลที่คั่นด้วยคอมมา
subject	String	เรื่องของอีเมล (สูงสุด 250 อักขระ)
body	String	เนื้อหาของอีเมล

รีเทิร์น

GmailApp — บริการ Gmail มีประโยชน์สำหรับการทำห่วงโซ่

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• sendEmail(recipient, subject, body, options)

---

sendEmail(recipient, subject, body, options)

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

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

พารามิเตอร์

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

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

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

รีเทิร์น

GmailApp — บริการ Gmail มีประโยชน์สำหรับการทำห่วงโซ่

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• sendEmail(recipient, subject, body)

---

setCurrentMessageAccessToken(accessToken)

ตั้งค่าข้อความปัจจุบัน โทเค็นเพื่อการเข้าถึงที่ช่วยให้สคริปต์เข้าถึงพร็อพเพอร์ตี้ GmailMessage ปัจจุบันได้

เฉพาะโปรเจ็กต์ส่วนเสริมของ Google Workspace ที่ใช้ขอบเขตข้อความปัจจุบันของ Gmail เท่านั้น ต้องการวิธีการนี้

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
}

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
accessToken	String	โทเค็นเพื่อการเข้าถึงชั่วคราวที่ได้รับจากออบเจ็กต์เหตุการณ์การดำเนินการของส่วนเสริม Gmail

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

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

• https://mail.google.com/

---

starMessage(message)

ติดดาวให้ข้อความนี้และบังคับให้รีเฟรชข้อความ

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
message	GmailMessage	ข้อความที่จะติดดาว

รีเทิร์น

GmailApp — บริการ Gmail มีประโยชน์สำหรับการทำห่วงโซ่

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• starMessages(messages)

---

starMessages(messages)

ติดดาวข้อความเหล่านี้และบังคับให้รีเฟรชข้อความ

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
messages	GmailMessage[]	อาร์เรย์ของข้อความที่จะติดดาว

รีเทิร์น

GmailApp — บริการ Gmail มีประโยชน์สำหรับการทำห่วงโซ่

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• starMessage(message)

---

unstarMessage(message)

นำดาวออกจากข้อความนี้และบังคับให้รีเฟรชข้อความ

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
message	GmailMessage	ข้อความที่จะยกเลิกการติดดาว

รีเทิร์น

GmailApp — บริการ Gmail มีประโยชน์สำหรับการทำห่วงโซ่

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• unstarMessages(messages)

---

unstarMessages(messages)

นำดาวออกจากข้อความเหล่านี้และบังคับให้รีเฟรชข้อความ

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
messages	GmailMessage[]	อาร์เรย์ของข้อความที่จะยกเลิกการติดดาว

รีเทิร์น

GmailApp — บริการ Gmail มีประโยชน์สำหรับการทำห่วงโซ่

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

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

• https://mail.google.com/

ดูเพิ่มเติม

• unstarMessage(message)

วิธีการที่เลิกใช้งานแล้ว

getChatThreads()

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรใช้ในสคริปต์ใหม่

รับชุดข้อความ Google Hangouts แบบคลาสสิกและชุดข้อความ Google Chat ทั้งหมดจนกว่า Google จะเปลี่ยนทั้งหมด ผู้ใช้ Hangouts แบบคลาสสิกไปยัง Chat ภายในปีนี้ ดูข้อมูลเพิ่มเติมได้ในเรียนรู้ เกี่ยวกับการเปลี่ยนจาก Hangouts แบบคลาสสิกเป็น Google Chat

การเรียกนี้ล้มเหลวเมื่อเทรดทั้งหมดมีขนาดใหญ่เกินกว่าที่ระบบจะจัดการได้ สถานที่ ไม่ทราบขนาดของชุดข้อความและอาจมีขนาดใหญ่มาก ให้ใช้ฟังก์ชัน "paged" เรียกและระบุ ของชุดข้อความที่จะดึงข้อมูลในการเรียกใช้แต่ละครั้ง

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

รีเทิร์น

GmailThread[] — ชุดชุดข้อความแชทจาก Gmail

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

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

• https://mail.google.com/

---

getChatThreads(start, max)

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรใช้ในสคริปต์ใหม่

รับชุดข้อความ Google Hangouts แบบคลาสสิกและชุดข้อความ Google Chat ที่หลากหลายจนกว่า Google จะเปลี่ยน ผู้ใช้ทั้งหมดของ Hangouts แบบคลาสสิกไปยัง Chat ภายในปีนี้ ดูข้อมูลเพิ่มเติมได้ในเรียนรู้ เกี่ยวกับการเปลี่ยนจาก Hangouts แบบคลาสสิกเป็น 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());

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
start	Integer	ดัชนีของชุดข้อความแรกที่ดึงข้อมูล
max	Integer	จำนวนเทรดสูงสุดที่จะดึงข้อมูล

รีเทิร์น

GmailThread[] — ชุดชุดข้อความ Gmail ที่หลากหลาย

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

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

• https://mail.google.com/