ข้อความฉบับร่างที่ผู้ใช้สร้างขึ้นในบัญชี Gmail ของผู้ใช้
เมธอด
| วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
|---|---|---|
delete | void | ลบข้อความฉบับร่างนี้ |
get | String | รับรหัสของข้อความฉบับร่างนี้ |
get | Gmail | แสดงผล GmailMessage ที่แสดงถึงฉบับร่างนี้ |
get | String | แสดงผลรหัสของ Gmail ที่แสดงฉบับร่างนี้ |
send() | Gmail | ส่งข้อความอีเมลฉบับร่างนี้ |
update(recipient, subject, body) | Gmail | แทนที่เนื้อหาของข้อความฉบับร่างนี้ |
update(recipient, subject, body, options) | Gmail | แทนที่เนื้อหาของข้อความฉบับร่างนี้โดยใช้อาร์กิวเมนต์ที่ไม่บังคับ |
เอกสารโดยละเอียด
deleteDraft()
ลบข้อความฉบับร่างนี้
const draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder draft.deleteDraft(); draft.getMessage(); // Throws exception.
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
getId()
รับรหัสของข้อความฉบับร่างนี้
const draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder const draftId = draft.getId(); const draftById = GmailApp.getDraft(draftId); Logger.log( draft.getMessage().getSubject() === draftById.getMessage().getSubject(), );
รีเทิร์น
String - ร่างรหัส
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
getMessage()
แสดงผล GmailMessage ที่แสดงถึงฉบับร่างนี้
const draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder const message = draft.getMessage(); Logger.log(message.getSubject());
รีเทิร์น
GmailMessage — ข้อความที่แสดงเนื้อหาของฉบับร่างนี้
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
getMessageId()
แสดงผลรหัสของ GmailMessage ที่แสดงฉบับร่างนี้
const draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder const messageId = draft.getMessageId(); Logger.log(messageId === draft.getMessage().getId());
รีเทิร์น
String - รหัสข้อความ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
send()
ส่งข้อความอีเมลฉบับร่างนี้ ขนาดของอีเมล (รวมถึงส่วนหัว) เกินโควต้า
const draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder const msg = draft.send(); // Send it Logger.log(msg.getDate()); // Should be approximately the current timestamp
รีเทิร์น
GmailMessage — ข้อความที่ส่งใหม่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
update(recipient, subject, body)
แทนที่เนื้อหาของข้อความฉบับร่างนี้ ขนาดของอีเมล (รวมถึงส่วนหัว) เกินโควต้า
// The code below will update a draft email with the current date and time. const draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder const now = new Date(); draft.update( 'mike@example.com', 'current time', `The time is: ${now.toString()}`, );
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
recipient | String | รายการอีเมลที่คั่นด้วยคอมมา |
subject | String | เรื่องของอีเมล (อักขระสูงสุด 250 ตัว) |
body | String | เนื้อหาของอีเมล |
รีเทิร์น
GmailDraft - ฉบับร่างที่เพิ่งอัปเดต
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/
ดูเพิ่มเติม
update(recipient, subject, body, options)
แทนที่เนื้อหาของข้อความฉบับร่างนี้โดยใช้อาร์กิวเมนต์ที่ไม่บังคับ อีเมลอาจมีข้อความธรรมดาหรือเนื้อหา HTML ขนาดของอีเมล (รวมถึงส่วนหัว) เกินโควต้า
// Update a draft email with a file from Google Drive attached as a PDF. const draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder const file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz'); draft.update( 'mike@example.com', 'Attachment example', 'Please see attached file.', { attachments: [file.getAs(MimeType.PDF)], name: 'Automatic Emailer Script', }, );
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
recipient | String | รายการอีเมลที่คั่นด้วยคอมมา |
subject | String | เรื่องของอีเมล (อักขระสูงสุด 250 ตัว) |
body | String | เนื้อหาของอีเมล |
options | Object | ออบเจ็กต์ JavaScript ที่ระบุพารามิเตอร์ขั้นสูงตามที่ระบุไว้ด้านล่าง |
พารามิเตอร์ขั้นสูง
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
attachments | Blob | อาร์เรย์ของไฟล์ที่จะส่งพร้อมกับอีเมล |
bcc | String | รายการที่คั่นด้วยคอมมาของที่อยู่อีเมลเพื่อส่งสำเนาลับ |
cc | String | รายการที่คั่นด้วยคอมมาของที่อยู่อีเมลเพื่อส่งสำเนา |
from | String | ที่อยู่ที่ควรส่งอีเมลจาก ซึ่งต้องเป็นค่าใดค่าหนึ่งที่ Gmail แสดงผล |
html | String | หากตั้งค่าไว้ อุปกรณ์ที่แสดงผล HTML ได้จะใช้ค่านี้แทน
อาร์กิวเมนต์เนื้อหาที่จำเป็น คุณสามารถเพิ่มฟิลด์ inline ที่ไม่บังคับในเนื้อหา HTML
ได้หากมีรูปภาพแบบอินไลน์สำหรับอีเมล |
inline | Object | ออบเจ็กต์ JavaScript ที่มีการแมปจากคีย์รูปภาพ
(String) ไปยังข้อมูลรูปภาพ (Blob) ซึ่งถือว่าใช้พารามิเตอร์ html และมีการอ้างอิงถึงรูปภาพเหล่านี้ในรูปแบบ <img src="cid:imageKey" /> |
name | String | ชื่อผู้ส่งอีเมล (ค่าเริ่มต้น: ชื่อของผู้ใช้) |
reply | String | อีเมลที่จะใช้เป็นที่อยู่สำหรับตอบกลับเริ่มต้น (ค่าเริ่มต้น: อีเมลของผู้ใช้) |
รีเทิร์น
GmailDraft - ฉบับร่างที่เพิ่งอัปเดต
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://mail.google.com/