ข้อความในบัญชี Gmail ของผู้ใช้
เมธอด
| วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
|---|---|---|
create | Gmail | สร้างข้อความฉบับร่างเพื่อตอบกลับผู้ส่งข้อความนี้โดยใช้ที่อยู่สำหรับตอบกลับ |
create | Gmail | สร้างข้อความฉบับร่างเพื่อตอบกลับผู้ส่งข้อความนี้โดยใช้ที่อยู่สำหรับตอบกลับ พร้อมด้วยอาร์กิวเมนต์ที่ไม่บังคับ |
create | Gmail | สร้างข้อความฉบับร่างเพื่อตอบกลับผู้ส่งโดยใช้ที่อยู่สำหรับตอบกลับและผู้รับทั้งหมดของข้อความนี้ |
create | Gmail | สร้างข้อความฉบับร่างเพื่อตอบกลับผู้ส่งข้อความนี้โดยใช้ที่อยู่สำหรับตอบกลับและ ผู้รับทั้งหมด พร้อมอาร์กิวเมนต์ที่ไม่บังคับ |
forward(recipient) | Gmail | ส่งต่อข้อความนี้ไปยังผู้รับรายใหม่ |
forward(recipient, options) | Gmail | ส่งต่อข้อความนี้ไปยังผู้รับใหม่พร้อมอาร์กิวเมนต์ที่ไม่บังคับ |
get | Gmail | รับไฟล์แนบทั้งหมดสำหรับข้อความนี้ |
get | Gmail | รับไฟล์แนบทั้งหมดสำหรับข้อความนี้ |
get | String | รับผู้รับที่ส่งสำเนาลับถึงในข้อความนี้โดยคั่นด้วยคอมมา |
get | String | รับเนื้อหา HTML ของเนื้อความของข้อความนี้ |
get | String | รับผู้รับที่ส่งสำเนาถึงซึ่งคั่นด้วยคอมมาในข้อความนี้ |
get | Date | รับวันที่และเวลาของข้อความนี้ |
get | String | รับผู้ส่งของข้อความนี้ |
get | String | รับค่าของส่วนหัว RFC 2822 เมื่อระบุชื่อส่วนหัว |
get | String | รับรหัสของข้อความนี้ |
get | String | รับเนื้อหาของเนื้อความของข้อความนี้โดยไม่มีการจัดรูปแบบ HTML |
get | String | รับเนื้อหาดิบของข้อความนี้ |
get | String | รับที่อยู่สำหรับตอบกลับของข้อความนี้ (โดยปกติคือผู้ส่ง) |
get | String | รับเรื่องของข้อความนี้ |
get | Gmail | รับชุดข้อความที่มีข้อความนี้ |
get | String | รับผู้รับข้อความนี้ที่คั่นด้วยคอมมา |
is | Boolean | รับว่าข้อความนี้เป็นฉบับร่างหรือไม่ |
is | Boolean | รับว่าข้อความนี้เป็นแชทหรือไม่ |
is | Boolean | รับว่าข้อความนี้อยู่ในกล่องจดหมายหรือไม่ |
is | Boolean | แสดงผล true หากข้อความนี้อยู่ในกล่องจดหมายสำคัญ หรือแสดงผล false ในกรณีอื่นๆ |
is | Boolean | ระบุว่าข้อความนี้อยู่ในถังขยะหรือไม่ |
is | Boolean | รับว่าข้อความนี้ติดดาวหรือไม่ |
is | Boolean | รับว่าข้อความนี้ยังไม่อ่านหรือไม่ |
mark | Gmail | ทำเครื่องหมายข้อความว่าอ่านแล้ว |
mark | Gmail | ทำเครื่องหมายข้อความว่ายังไม่อ่าน |
move | Gmail | ย้ายข้อความไปที่ถังขยะ |
refresh() | Gmail | โหลดข้อความนี้และสถานะที่เกี่ยวข้องจาก Gmail อีกครั้ง (มีประโยชน์ในกรณีที่ป้ายกำกับ สถานะอ่านแล้ว ฯลฯ มีการเปลี่ยนแปลง) |
reply(body) | Gmail | ตอบกลับผู้ส่งข้อความนี้โดยใช้ที่อยู่สำหรับการตอบกลับ |
reply(body, options) | Gmail | ตอบกลับผู้ส่งข้อความนี้โดยใช้ที่อยู่สำหรับตอบกลับ พร้อมอาร์กิวเมนต์ที่ไม่บังคับ |
reply | Gmail | ตอบกลับผู้ส่งโดยใช้ที่อยู่สำหรับตอบกลับและผู้รับทั้งหมดของข้อความนี้ |
reply | Gmail | ตอบกลับผู้ส่งข้อความนี้โดยใช้ที่อยู่สำหรับตอบกลับและผู้รับทั้งหมด พร้อมด้วยอาร์กิวเมนต์ที่ไม่บังคับ |
star() | Gmail | ติดดาวข้อความ |
unstar() | Gmail | ยกเลิกการติดดาวข้อความ |
เอกสารโดยละเอียด
createDraftReply(body)
สร้างข้อความฉบับร่างเพื่อตอบกลับผู้ส่งข้อความนี้โดยใช้ที่อยู่สำหรับตอบกลับ ขนาดของอีเมล (รวมถึงส่วนหัว) จำกัดโควต้า
// Create a draft reply to the original message with an acknowledgment. const firstThread = GmailApp.getInboxThreads(0, 1)[0]; const message = firstThread.getMessages()[0]; message.createDraftReply('Got your message');
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
body | String | เนื้อหาของอีเมล |
รีเทิร์น
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]; const message = firstThread.getMessages()[0]; message.createDraftReply('incapable of HTML', { htmlBody: '<b>some HTML body text</b>', cc: 'another@example.com', });
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
body | String | เนื้อหาของอีเมล |
options | Object | ออบเจ็กต์ JavaScript ที่ระบุพารามิเตอร์ขั้นสูงตามที่ระบุไว้ด้านล่าง |
พารามิเตอร์ขั้นสูง
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
attachments | Blob | อาร์เรย์ของไฟล์ที่จะส่งพร้อมกับอีเมล |
bcc | String | รายการที่คั่นด้วยคอมมาของที่อยู่อีเมลเพื่อส่งสำเนาลับ |
cc | String | รายการที่คั่นด้วยคอมมาของที่อยู่อีเมลเพื่อส่งสำเนา |
from | String | ที่อยู่ที่ควรส่งอีเมลจาก ซึ่งต้องเป็นค่าใดค่าหนึ่งที่ Gmail แสดงผล |
html | String | เมื่อตั้งค่าแล้ว อุปกรณ์ที่แสดงผล HTML ได้จะใช้ค่านี้แทนอาร์กิวเมนต์ body ที่จำเป็น คุณสามารถเพิ่มฟิลด์ inline ที่ไม่บังคับในส่วนเนื้อหา HTML ได้ หากมีรูปภาพในอีเมล |
inline | Object | ออบเจ็กต์ JavaScript ที่มีการแมปจากคีย์รูปภาพ
(String) ไปยังข้อมูลรูปภาพ (Blob) ซึ่งถือว่าใช้พารามิเตอร์ html และมีการอ้างอิงถึงรูปภาพเหล่านี้ในรูปแบบ <img src="cid:imageKey" /> |
name | String | ชื่อผู้ส่งอีเมล (ค่าเริ่มต้น: ชื่อของผู้ใช้) |
reply | String | อีเมลที่จะใช้เป็นที่อยู่สำหรับตอบกลับเริ่มต้น (ค่าเริ่มต้น: อีเมลของผู้ใช้) |
subject | String | บรรทัดเรื่องใหม่สำหรับอีเมล โดยมีความยาวได้ไม่เกิน 250 อักขระ |
รีเทิร์น
GmailDraft - ข้อความร่างที่สร้างขึ้นใหม่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
ดูเพิ่มเติม
createDraftReplyAll(body)
สร้างข้อความฉบับร่างเพื่อตอบกลับผู้ส่งโดยใช้ที่อยู่สำหรับตอบกลับและผู้รับทั้งหมดของข้อความนี้ ขนาดของอีเมล (รวมถึงส่วนหัว) เกินโควต้า
// Create a draft response to all recipients (except those bcc'd) with an // acknowledgment. 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/
ดูเพิ่มเติม
createDraftReplyAll(body, options)
สร้างข้อความฉบับร่างเพื่อตอบกลับผู้ส่งข้อความนี้โดยใช้ที่อยู่สำหรับตอบกลับและ ผู้รับทั้งหมด พร้อมอาร์กิวเมนต์ที่ไม่บังคับ
อีเมลมีได้ทั้งข้อความธรรมดาและเนื้อหา HTML ขนาดของอีเมล (รวมถึง ส่วนหัว) เกินโควต้า ที่กำหนด
// Create a draft response to all recipients (except those bcc'd) using an HTML // text body. const firstThread = GmailApp.getInboxThreads(0, 1)[0]; const message = firstThread.getMessages()[0]; message.createDraftReplyAll('incapable of HTML', { htmlBody: '<b>some HTML body text</b>', cc: 'another@example.com', });
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
body | String | เนื้อหาของอีเมล |
options | Object | ออบเจ็กต์ JavaScript ที่ระบุพารามิเตอร์ขั้นสูงตามที่ระบุไว้ด้านล่าง |
พารามิเตอร์ขั้นสูง
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
attachments | Blob | อาร์เรย์ของไฟล์ที่จะส่งพร้อมกับอีเมล |
bcc | String | รายการที่คั่นด้วยคอมมาของที่อยู่อีเมลเพื่อส่งสำเนาลับ |
cc | String | รายการที่คั่นด้วยคอมมาของที่อยู่อีเมลเพื่อส่งสำเนา |
from | String | ที่อยู่ที่ควรส่งอีเมลจาก ซึ่งต้องเป็นค่าใดค่าหนึ่งที่ Gmail แสดงผล |
html | String | เมื่อตั้งค่าแล้ว อุปกรณ์ที่แสดงผล HTML ได้จะใช้ค่านี้แทนอาร์กิวเมนต์ body ที่จำเป็น คุณสามารถเพิ่มฟิลด์ inline ที่ไม่บังคับในส่วนเนื้อหา HTML ได้ หากมีรูปภาพในอีเมล |
inline | Object | ออบเจ็กต์ JavaScript ที่มีการแมปจากคีย์รูปภาพ
(String) ไปยังข้อมูลรูปภาพ (Blob) ซึ่งถือว่าใช้พารามิเตอร์ html และมีการอ้างอิงถึงรูปภาพเหล่านี้ในรูปแบบ <img src="cid:imageKey" /> |
name | String | ชื่อผู้ส่งอีเมล (ค่าเริ่มต้น: ชื่อของผู้ใช้) |
reply | String | อีเมลที่จะใช้เป็นที่อยู่สำหรับตอบกลับเริ่มต้น (ค่าเริ่มต้น: อีเมลของผู้ใช้) |
subject | String | บรรทัดเรื่องใหม่สำหรับอีเมล โดยมีความยาวได้ไม่เกิน 250 อักขระ |
รีเทิร์น
GmailDraft - ข้อความร่างที่สร้างขึ้นใหม่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
ดูเพิ่มเติม
forward(recipient)
ส่งต่อข้อความนี้ไปยังผู้รับรายใหม่ ขนาดของอีเมล (รวมถึงส่วนหัว) เกินโควต้า
// Forward first message of first inbox thread to recipient1 & recipient2, // both @example.com const firstThread = GmailApp.getInboxThreads(0, 1)[0]; const message = firstThread.getMessages()[0]; message.forward('recipient1@example.com,recipient2@example.com');
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
recipient | String | รายการที่คั่นด้วยคอมมาของที่อยู่อีเมล |
รีเทิร์น
GmailMessage — ข้อความนี้มีประโยชน์สำหรับการเชื่อมโยง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
ดูเพิ่มเติม
forward(recipient, options)
ส่งต่อข้อความนี้ไปยังผู้รับใหม่พร้อมอาร์กิวเมนต์ที่ไม่บังคับ
อีเมลอาจมีทั้งข้อความธรรมดาและเนื้อหา HTML ขนาดของอีเมล (รวมถึงส่วนหัว) quota limited
const firstThread = GmailApp.getInboxThreads(0, 1)[0]; const message = firstThread.getMessages()[0]; message.forward('recipient1@example.com,recipient2@example.com', { cc: 'myboss@example.com', bcc: 'mybosses-boss@example.com,vp@example.com', });
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
recipient | String | รายการที่คั่นด้วยคอมมาของที่อยู่อีเมล |
options | Object | ออบเจ็กต์ JavaScript ที่ระบุพารามิเตอร์ขั้นสูงตามที่ระบุไว้ด้านล่าง |
พารามิเตอร์ขั้นสูง
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
attachments | Blob | อาร์เรย์ของไฟล์ที่จะส่งพร้อมกับอีเมล |
bcc | String | รายการที่คั่นด้วยคอมมาของที่อยู่อีเมลเพื่อส่งสำเนาลับ |
cc | String | รายการที่คั่นด้วยคอมมาของที่อยู่อีเมลเพื่อส่งสำเนา |
from | String | ที่อยู่ที่ควรส่งอีเมลจาก ซึ่งต้องเป็นค่าใดค่าหนึ่งที่ Gmail แสดงผล |
html | String | เมื่อตั้งค่าแล้ว อุปกรณ์ที่แสดงผล HTML ได้จะใช้ค่านี้แทนอาร์กิวเมนต์ body ที่จำเป็น คุณสามารถเพิ่มฟิลด์ inline ที่ไม่บังคับในส่วนเนื้อหา HTML ได้ หากมีรูปภาพในอีเมล |
inline | Object | ออบเจ็กต์ JavaScript ที่มีการแมปจากคีย์รูปภาพ
(String) ไปยังข้อมูลรูปภาพ (Blob) ซึ่งถือว่าใช้พารามิเตอร์ html และมีการอ้างอิงถึงรูปภาพเหล่านี้ในรูปแบบ <img src="cid:imageKey" /> |
name | String | ชื่อผู้ส่งอีเมล (ค่าเริ่มต้น: ชื่อของผู้ใช้) |
no | Boolean | true หากควรส่งอีเมลจากอีเมลแบบทั่วไป
ที่ไม่อนุญาตให้ตอบกลับเพื่อไม่ให้ผู้รับตอบกลับอีเมล ตัวเลือกนี้ใช้ได้กับ
บัญชี Google Workspace เท่านั้น ไม่ใช่ผู้ใช้ Gmail |
reply | String | อีเมลที่จะใช้เป็นที่อยู่สำหรับตอบกลับเริ่มต้น (ค่าเริ่มต้น: อีเมลของผู้ใช้) |
subject | String | บรรทัดเรื่องใหม่สำหรับอีเมล โดยมีความยาวได้ไม่เกิน 250 อักขระ |
รีเทิร์น
GmailMessage — ข้อความนี้มีประโยชน์สำหรับการเชื่อมโยง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
ดูเพิ่มเติม
getAttachments()
รับไฟล์แนบทั้งหมดสำหรับข้อความนี้
รีเทิร์น
GmailAttachment[] - อาร์เรย์ของไฟล์แนบ Blob สำหรับข้อความนี้
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
getAttachments(options)
รับไฟล์แนบทั้งหมดสำหรับข้อความนี้
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
options | Object | ออบเจ็กต์ JavaScript ที่ระบุพารามิเตอร์ขั้นสูงตามที่ระบุไว้ด้านล่าง |
พารามิเตอร์ขั้นสูง
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
include | Boolean | true หากอาร์เรย์ของไฟล์แนบ Blob ที่แสดงผลควรมีรูปภาพในบรรทัด (ค่าเริ่มต้นคือ true) |
include | Boolean | true หากอาร์เรย์ของ Blob
ที่ส่งคืนควรมีไฟล์แนบปกติ (ไม่ใช่แบบอินไลน์) (ค่าเริ่มต้นคือ true) |
รีเทิร์น
GmailAttachment[] - อาร์เรย์ของไฟล์แนบ Blob สำหรับข้อความนี้
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
getBcc()
รับผู้รับที่ส่งสำเนาลับถึงในข้อความนี้โดยคั่นด้วยคอมมา
ฟิลด์นี้จะว่างเปล่าสำหรับข้อความที่ได้รับทั้งหมดตามคำจำกัดความ
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message Logger.log(message.getBcc()); // Log bcc'd addresses
รีเทิร์น
String - ผู้รับที่ส่งสำเนาลับถึงในข้อความนี้ซึ่งคั่นด้วยคอมมา
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
ดูเพิ่มเติม
getBody()
รับเนื้อหา HTML ของเนื้อความของข้อความนี้
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message Logger.log(message.getBody()); // Log contents of the body
รีเทิร์น
String — เนื้อหาของข้อความนี้
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
ดูเพิ่มเติม
getCc()
รับผู้รับที่ส่งสำเนาถึงซึ่งคั่นด้วยคอมมาในข้อความนี้
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message Logger.log(message.getCc()); // Log cc'd addresses
รีเทิร์น
String — ผู้รับที่ส่งสำเนาถึงในข้อความนี้ซึ่งคั่นด้วยคอมมา
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
ดูเพิ่มเติม
getDate()
รับวันที่และเวลาของข้อความนี้
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message Logger.log(message.getDate()); // Log date and time of the message
รีเทิร์น
Date - วันที่และเวลาของข้อความนี้
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
getFrom()
รับผู้ส่งของข้อความนี้
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message Logger.log(message.getFrom()); // Log from address of the message
รีเทิร์น
String — ที่อยู่อีเมลของผู้ส่งข้อความ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
ดูเพิ่มเติม
getHeader(name)
รับค่าของส่วนหัว RFC 2822 เมื่อระบุชื่อส่วนหัว
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox. const message = thread.getMessages()[0]; // Get the first message. Logger.log( message.getHeader('Message-ID')); // Logs the Message-ID RFC 2822 header.
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
name | String | ชื่อของส่วนหัว RFC โดยไม่มีโคลอนที่คั่นออกจากค่า |
รีเทิร์น
String — ค่าของส่วนหัว หรือสตริงว่างหากไม่มีส่วนหัวในข้อความ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
getId()
รับรหัสของข้อความนี้
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message const id = message.getId(); const messageById = GmailApp.getMessageById(id); Logger.log( message.getSubject() === messageById.getMessage()); // Always logs true
รีเทิร์น
String - รหัสข้อความ
getPlainBody()
รับเนื้อหาของเนื้อความของข้อความนี้โดยไม่มีการจัดรูปแบบ HTML ซึ่งมีความซับซ้อนมากกว่า
getBody()และใช้เวลานานกว่า
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message Logger.log(message.getPlainBody()); // Log contents of the body
รีเทิร์น
String — เนื้อหาข้อความแบบข้อความธรรมดาของข้อความนี้
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
ดูเพิ่มเติม
getRawContent()
รับเนื้อหาดิบของข้อความนี้ ซึ่งเทียบเท่ากับ "แสดงต้นฉบับ" ใน UI ของ Gmail
รีเทิร์น
String — เนื้อหาดิบของข้อความนี้
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
getReplyTo()
รับที่อยู่สำหรับตอบกลับของข้อความนี้ (โดยปกติคือผู้ส่ง)
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message Logger.log(message.getReplyTo()); // Logs reply-to address
รีเทิร์น
String - อีเมลสำหรับตอบกลับ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
ดูเพิ่มเติม
getSubject()
รับเรื่องของข้อความนี้
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message Logger.log(message.getSubject()); // Log subject line
รีเทิร์น
String — เรื่องของข้อความนี้
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
ดูเพิ่มเติม
getThread()
รับชุดข้อความที่มีข้อความนี้
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message Logger.log( message.getThread().getFirstMessageSubject() === thread.getFirstMessageSubject(), ); // Always logs true
รีเทิร์น
GmailThread — เธรด Gmail ที่มีข้อความนี้
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
getTo()
รับผู้รับข้อความนี้ที่คั่นด้วยคอมมา
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message Logger.log(message.getTo()); // Log the recipient of message
รีเทิร์น
String - ผู้รับข้อความนี้ที่คั่นด้วยคอมมา
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
ดูเพิ่มเติม
isDraft()
รับว่าข้อความนี้เป็นฉบับร่างหรือไม่
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message Logger.log(`is draft? ${message.isDraft()}`);
รีเทิร์น
Boolean — ข้อความนี้เป็นฉบับร่างหรือไม่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
isInChats()
รับว่าข้อความนี้เป็นแชทหรือไม่
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message Logger.log(`is a chat? ${message.isInChats()}`);
รีเทิร์น
Boolean — ข้อความนี้เป็นแชทหรือไม่
isInInbox()
รับว่าข้อความนี้อยู่ในกล่องจดหมายหรือไม่
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message Logger.log(`is in inbox? ${message.isInInbox()}`);
รีเทิร์น
Boolean — ข้อความนี้อยู่ในกล่องจดหมายหรือไม่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
isInPriorityInbox()
แสดงผล true หากข้อความนี้อยู่ในกล่องจดหมายสำคัญ หรือแสดงผล false ในกรณีอื่นๆ
const thread = GmailApp.getPriorityInboxThreads( 0, 1)[0]; // Get first thread in priority inbox const messages = thread.getMessages(); for (let i = 0; i < messages.length; i++) { // At least one of the messages is in priority inbox Logger.log(`is in priority inbox? ${messages[i].isInPriorityInbox()}`); }
รีเทิร์น
Boolean — อีเมลนี้อยู่ในกล่องจดหมายสำคัญหรือไม่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
isInTrash()
ระบุว่าข้อความนี้อยู่ในถังขยะหรือไม่
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message Logger.log(`is in the trash? ${message.isInTrash()}`);
รีเทิร์น
Boolean — ข้อความนี้อยู่ในถังขยะหรือไม่
isStarred()
รับว่าข้อความนี้ติดดาวหรือไม่
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message Logger.log(`is starred? ${message.isStarred()}`);
รีเทิร์น
Boolean — ข้อความนี้ติดดาวหรือไม่
isUnread()
รับว่าข้อความนี้ยังไม่อ่านหรือไม่
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message Logger.log(`is unread? ${message.isUnread()}`);
รีเทิร์น
Boolean — สถานะยังไม่อ่านของข้อความนี้
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
markRead()
ทำเครื่องหมายข้อความว่าอ่านแล้ว
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message message.markRead(); // Mark as read
รีเทิร์น
GmailMessage - GmailMessage นี้มีประโยชน์สำหรับการเชื่อมโยง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
ดูเพิ่มเติม
markUnread()
ทำเครื่องหมายข้อความว่ายังไม่อ่าน
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message message.markUnread(); // Mark as unread
รีเทิร์น
GmailMessage - GmailMessage นี้มีประโยชน์สำหรับการเชื่อมโยง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
ดูเพิ่มเติม
moveToTrash()
ย้ายข้อความไปที่ถังขยะ
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message message.moveToTrash(); // Move message to trash
รีเทิร์น
GmailMessage - GmailMessage นี้มีประโยชน์สำหรับการเชื่อมโยง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
ดูเพิ่มเติม
refresh()
โหลดข้อความนี้และสถานะที่เกี่ยวข้องจาก Gmail อีกครั้ง (มีประโยชน์ในกรณีที่ป้ายกำกับ สถานะอ่านแล้ว ฯลฯ มีการเปลี่ยนแปลง)
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message // .. Do bunch of stuff here message.refresh(); // Make sure it's up to date // Do more stuff to message
รีเทิร์น
GmailMessage — ข้อความนี้ใช้สำหรับการต่อข้อความ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
reply(body)
ตอบกลับผู้ส่งข้อความนี้โดยใช้ที่อยู่สำหรับการตอบกลับ ขนาดของอีเมล (รวมถึงส่วนหัว) quota limited
// Respond to author of message with acknowledgment const firstThread = GmailApp.getInboxThreads(0, 1)[0]; const message = firstThread.getMessages()[0]; message.reply('Got your message');
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
body | String | เนื้อหาของอีเมล |
รีเทิร์น
GmailMessage — ข้อความนี้มีประโยชน์สำหรับการเชื่อมโยง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
ดูเพิ่มเติม
reply(body, options)
ตอบกลับผู้ส่งข้อความนี้โดยใช้ที่อยู่สำหรับตอบกลับ พร้อมอาร์กิวเมนต์ที่ไม่บังคับ
อีเมลอาจมีทั้งข้อความธรรมดาและเนื้อหา HTML ขนาดของอีเมล (รวมถึงส่วนหัว) quota limited
// Respond with HTML body text const firstThread = GmailApp.getInboxThreads(0, 1)[0]; const message = firstThread.getMessages()[0]; message.reply('incapable of HTML', { htmlBody: '<b>some HTML body text</b>', noReply: true, });
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
body | String | เนื้อหาของอีเมล |
options | Object | ออบเจ็กต์ JavaScript ที่ระบุพารามิเตอร์ขั้นสูงตามที่ระบุไว้ด้านล่าง |
พารามิเตอร์ขั้นสูง
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
attachments | Blob | อาร์เรย์ของไฟล์ที่จะส่งพร้อมกับอีเมล |
bcc | String | รายการที่คั่นด้วยคอมมาของที่อยู่อีเมลเพื่อส่งสำเนาลับ |
cc | String | รายการที่คั่นด้วยคอมมาของที่อยู่อีเมลเพื่อส่งสำเนา |
from | String | ที่อยู่ที่ควรส่งอีเมลจาก ซึ่งต้องเป็นค่าใดค่าหนึ่งที่ Gmail แสดงผล |
html | String | เมื่อตั้งค่าแล้ว อุปกรณ์ที่แสดงผล HTML ได้จะใช้ค่านี้แทนอาร์กิวเมนต์ body ที่จำเป็น คุณสามารถเพิ่มฟิลด์ inline ที่ไม่บังคับในส่วนเนื้อหา HTML ได้ หากมีรูปภาพในอีเมล |
inline | Object | ออบเจ็กต์ JavaScript ที่มีการแมปจากคีย์รูปภาพ
(String) ไปยังข้อมูลรูปภาพ (Blob) ซึ่งถือว่าใช้พารามิเตอร์ html และมีการอ้างอิงถึงรูปภาพเหล่านี้ในรูปแบบ <img src="cid:imageKey" /> |
name | String | ชื่อผู้ส่งอีเมล (ค่าเริ่มต้น: ชื่อของผู้ใช้) |
no | Boolean | true หากควรส่งอีเมลจากอีเมลแบบทั่วไป
ที่ไม่อนุญาตให้ตอบกลับเพื่อไม่ให้ผู้รับตอบกลับอีเมล ตัวเลือกนี้ใช้ได้กับ
บัญชี Google Workspace เท่านั้น ไม่ใช่ผู้ใช้ Gmail |
reply | String | อีเมลที่จะใช้เป็นที่อยู่สำหรับตอบกลับเริ่มต้น (ค่าเริ่มต้น: อีเมลของผู้ใช้) |
subject | String | บรรทัดเรื่องใหม่สำหรับอีเมล โดยมีความยาวได้ไม่เกิน 250 อักขระ |
รีเทิร์น
GmailMessage — ข้อความนี้มีประโยชน์สำหรับการเชื่อมโยง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
ดูเพิ่มเติม
replyAll(body)
ตอบกลับผู้ส่งโดยใช้ที่อยู่สำหรับตอบกลับและผู้รับทั้งหมดของข้อความนี้ ขนาด ของอีเมล (รวมถึงส่วนหัว) เกินโควต้า
// Respond to all recipients (except bcc'd) of last email in thread with // acknowledgment const firstThread = GmailApp.getInboxThreads(0, 1)[0]; const message = firstThread.getMessages()[0]; message.replyAll('Got your message');
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
body | String | เนื้อหาของอีเมล |
รีเทิร์น
GmailMessage — ข้อความนี้มีประโยชน์สำหรับการเชื่อมโยง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
ดูเพิ่มเติม
replyAll(body, options)
ตอบกลับผู้ส่งข้อความนี้โดยใช้ที่อยู่สำหรับตอบกลับและผู้รับทั้งหมด พร้อมด้วยอาร์กิวเมนต์ที่ไม่บังคับ
อีเมลอาจมีทั้งข้อความธรรมดาและเนื้อหา HTML ขนาดของอีเมล (รวมถึงส่วนหัว) quota limited
// Respond with HTML body text const firstThread = GmailApp.getInboxThreads(0, 1)[0]; const message = firstThread.getMessages()[0]; message.replyAll('incapable of HTML', { htmlBody: '<b>some HTML body text</b>', noReply: true, });
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
body | String | เนื้อหาของอีเมล |
options | Object | ออบเจ็กต์ JavaScript ที่ระบุพารามิเตอร์ขั้นสูงตามที่ระบุไว้ด้านล่าง |
พารามิเตอร์ขั้นสูง
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
attachments | Blob | อาร์เรย์ของไฟล์ที่จะส่งพร้อมกับอีเมล |
bcc | String | รายการที่คั่นด้วยคอมมาของที่อยู่อีเมลเพื่อส่งสำเนาลับ |
cc | String | รายการที่คั่นด้วยคอมมาของที่อยู่อีเมลเพื่อส่งสำเนา |
from | String | ที่อยู่ที่ควรส่งอีเมลจาก ซึ่งต้องเป็นค่าใดค่าหนึ่งที่ Gmail แสดงผล |
html | String | เมื่อตั้งค่าแล้ว อุปกรณ์ที่แสดงผล HTML ได้จะใช้ค่านี้แทนอาร์กิวเมนต์ body ที่จำเป็น คุณสามารถเพิ่มฟิลด์ inline ที่ไม่บังคับในส่วนเนื้อหา HTML ได้ หากมีรูปภาพในอีเมล |
inline | Object | ออบเจ็กต์ JavaScript ที่มีการแมปจากคีย์รูปภาพ
(String) ไปยังข้อมูลรูปภาพ (Blob) ซึ่งถือว่าใช้พารามิเตอร์ html และมีการอ้างอิงถึงรูปภาพเหล่านี้ในรูปแบบ <img src="cid:imageKey" /> |
name | String | ชื่อผู้ส่งอีเมล (ค่าเริ่มต้น: ชื่อของผู้ใช้) |
no | Boolean | true หากควรส่งอีเมลจากอีเมลแบบทั่วไป
ที่ไม่อนุญาตให้ตอบกลับเพื่อไม่ให้ผู้รับตอบกลับอีเมล ตัวเลือกนี้ใช้ได้กับ
บัญชี Google Workspace เท่านั้น ไม่ใช่ผู้ใช้ Gmail |
reply | String | อีเมลที่จะใช้เป็นที่อยู่สำหรับตอบกลับเริ่มต้น (ค่าเริ่มต้น: อีเมลของผู้ใช้) |
subject | String | บรรทัดเรื่องใหม่สำหรับอีเมล โดยมีความยาวได้ไม่เกิน 250 อักขระ |
รีเทิร์น
GmailMessage — ข้อความนี้มีประโยชน์สำหรับการเชื่อมโยง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
ดูเพิ่มเติม
star()
ติดดาวข้อความ
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message message.star(); // Star the message
รีเทิร์น
GmailMessage - GmailMessage นี้มีประโยชน์สำหรับการเชื่อมโยง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
ดูเพิ่มเติม
unstar()
ยกเลิกการติดดาวข้อความ
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message message.unstar(); // Unstar the message
รีเทิร์น
GmailMessage - GmailMessage นี้มีประโยชน์สำหรับการเชื่อมโยง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/