ข้อความในบัญชี 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 | ยกเลิกการติดดาวข้อความ |
เอกสารประกอบโดยละเอียด
create Draft Reply(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 | เนื้อความของอีเมล |
รีเทิร์น
Gmail
— ข้อความร่างที่สร้างใหม่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการหรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
ดูเพิ่มเติม
create Draft Reply(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 อักขระ |
รีเทิร์น
Gmail
— ข้อความร่างที่สร้างใหม่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการหรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
ดูเพิ่มเติม
create Draft Reply All(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 | เนื้อความของอีเมล |
รีเทิร์น
Gmail
— ข้อความร่างที่สร้างใหม่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการหรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
ดูเพิ่มเติม
create Draft Reply All(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 อักขระ |
รีเทิร์น
Gmail
— ข้อความร่างที่สร้างใหม่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 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 | รายการอีเมลที่คั่นด้วยคอมมา |
รีเทิร์น
Gmail
— ข้อความนี้มีประโยชน์สำหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการหรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
ดูเพิ่มเติม
forward(recipient, options)
ส่งต่อข้อความนี้ไปยังผู้รับใหม่พร้อมอาร์กิวเมนต์ที่ไม่บังคับ
อีเมลมีทั้งข้อความธรรมดาและเนื้อหา HTML ขนาดของอีเมล (รวมถึงส่วนหัว) เกินโควต้า
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 อักขระ |
รีเทิร์น
Gmail
— ข้อความนี้มีประโยชน์สำหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการหรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
ดูเพิ่มเติม
get Attachments()
รับไฟล์แนบทั้งหมดของข้อความนี้
รีเทิร์น
Gmail
— อาร์เรย์ของไฟล์แนบ Blob สำหรับข้อความนี้
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการหรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
get Attachments(options)
รับไฟล์แนบทั้งหมดของข้อความนี้
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
options | Object | ออบเจ็กต์ JavaScript ที่ระบุพารามิเตอร์ขั้นสูงตามที่ระบุไว้ด้านล่าง |
พารามิเตอร์ขั้นสูง
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
include | Boolean | true หากอาร์เรย์ไฟล์แนบ Blob ที่แสดงผลควรมีรูปภาพในบรรทัด (ค่าเริ่มต้นคือ true ) |
include | Boolean | true หากอาร์เรย์ไฟล์แนบ Blob ที่แสดงผลควรรวมไฟล์แนบปกติ (ไม่ใช่แบบแทรกในบรรทัด) (ค่าเริ่มต้นคือ true ) |
รีเทิร์น
Gmail
— อาร์เรย์ของไฟล์แนบ Blob สำหรับข้อความนี้
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการหรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
get Bcc()
รับผู้รับสำเนาลับในข้อความนี้โดยคั่นด้วยคอมมา
โดยค่าเริ่มต้น ค่านี้จะว่างเปล่าสำหรับข้อความที่ได้รับทั้งหมด
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/
ดูเพิ่มเติม
get Body()
รับเนื้อหา 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/
ดูเพิ่มเติม
get Cc()
รับผู้รับที่ส่งสำเนาถึงในข้อความนี้โดยคั่นด้วยคอมมา
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/
ดูเพิ่มเติม
get Date()
รับวันที่และเวลาของข้อความนี้
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/
get From()
รับข้อมูลผู้ส่งข้อความนี้
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/
ดูเพิ่มเติม
get Header(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/
get Id()
รับรหัสของข้อความนี้
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
- รหัสข้อความ
get Plain Body()
รับเนื้อหาของเนื้อหาข้อความนี้โดยไม่มีการจัดรูปแบบ HTML ซึ่งมีความซับซ้อนกว่า get
และใช้เวลานานกว่า
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/
ดูเพิ่มเติม
get Raw Content()
รับเนื้อหาดิบของข้อความนี้ ซึ่งเทียบเท่ากับ "แสดงต้นฉบับ" ใน UI ของ Gmail
รีเทิร์น
String
— เนื้อหาดิบของข้อความนี้
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการหรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
get Reply To()
รับที่อยู่สำหรับตอบกลับของข้อความนี้ (โดยปกติคือผู้ส่ง)
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/
ดูเพิ่มเติม
get Subject()
รับหัวเรื่องของข้อความนี้
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/
ดูเพิ่มเติม
get Thread()
รับชุดข้อความที่มีข้อความนี้
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
รีเทิร์น
Gmail
— GmailThread ที่มีข้อความนี้
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการหรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
get To()
รับผู้รับข้อความนี้ที่คั่นด้วยคอมมา
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/
ดูเพิ่มเติม
is Draft()
รับว่าข้อความนี้เป็นข้อความร่างหรือไม่
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/
is In Chats()
รับว่าข้อความนี้เป็นแชทหรือไม่
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
— ข้อความนี้เป็นแชทหรือไม่
is In Inbox()
รับว่าข้อความนี้อยู่ในกล่องจดหมายหรือไม่
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/
is In Priority Inbox()
แสดงผล 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/
is In Trash()
รับว่าข้อความนี้อยู่ในถังขยะหรือไม่
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
— ข้อความนี้อยู่ในถังขยะหรือไม่
is Starred()
รับข้อมูลว่าข้อความนี้ติดดาวหรือไม่
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
— ข้อความนี้มีการติดดาวหรือไม่
is Unread()
รับข้อมูลว่าข้อความนี้ยังไม่อ่านหรือไม่
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/
mark Read()
ทำเครื่องหมายข้อความว่าอ่านแล้ว
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
รีเทิร์น
Gmail
— GmailMessage นี้มีประโยชน์สำหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการหรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
ดูเพิ่มเติม
mark Unread()
ทำเครื่องหมายข้อความว่ายังไม่อ่าน
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
รีเทิร์น
Gmail
— GmailMessage นี้มีประโยชน์สำหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการหรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
ดูเพิ่มเติม
move To Trash()
ย้ายข้อความไปที่ถังขยะ
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
รีเทิร์น
Gmail
— 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
รีเทิร์น
Gmail
— ข้อความนี้สำหรับใช้ต่อท้าย
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการหรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
reply(body)
ตอบกลับผู้ส่งข้อความนี้โดยใช้ที่อยู่ "ตอบกลับ" ขนาดของอีเมล (รวมถึงส่วนหัว) เกินโควต้า
// 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 | เนื้อความของอีเมล |
รีเทิร์น
Gmail
— ข้อความนี้มีประโยชน์สำหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการหรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
ดูเพิ่มเติม
reply(body, options)
ตอบกลับผู้ส่งข้อความนี้โดยใช้อีเมลตอบกลับพร้อมอาร์กิวเมนต์ที่ไม่บังคับ
อีเมลมีทั้งข้อความธรรมดาและเนื้อหา HTML ขนาดของอีเมล (รวมถึงส่วนหัว) เกินโควต้า
// 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 อักขระ |
รีเทิร์น
Gmail
— ข้อความนี้มีประโยชน์สำหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการหรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
ดูเพิ่มเติม
reply All(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 | เนื้อความของอีเมล |
รีเทิร์น
Gmail
— ข้อความนี้มีประโยชน์สำหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการหรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
ดูเพิ่มเติม
reply All(body, options)
ตอบกลับผู้ส่งข้อความนี้โดยใช้อีเมลตอบกลับและผู้รับทั้งหมดพร้อมอาร์กิวเมนต์ที่ไม่บังคับ
อีเมลมีทั้งข้อความธรรมดาและเนื้อหา HTML ขนาดของอีเมล (รวมถึงส่วนหัว) เกินโควต้า
// 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 อักขระ |
รีเทิร์น
Gmail
— ข้อความนี้มีประโยชน์สำหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 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
รีเทิร์น
Gmail
— 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
รีเทิร์น
Gmail
— GmailMessage นี้มีประโยชน์สำหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการหรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/