เอกสารนี้อธิบายวิธีสร้าง อัปเดต และส่งอีเมลฉบับร่างโดยใช้ Gmail API
ข้อความร่างในอีเมลแสดงถึงข้อความที่ยังไม่ได้ส่งซึ่งมีDRAFTป้ายกำกับของระบบ
เมื่อสร้างข้อความในฉบับร่างแล้วจะแก้ไขไม่ได้ แต่สามารถแทนที่ได้ ในแง่นี้ ทรัพยากร
drafts คือคอนเทนเนอร์ที่มีรหัสที่เสถียรเนื่องจากรหัสข้อความพื้นฐานจะเปลี่ยน
ทุกครั้งที่มีการแทนที่ข้อความ
แหล่งข้อมูล messages
ภายในฉบับร่างจะมีลักษณะการทำงานคล้ายกับข้อความอื่นๆ ยกเว้นความแตกต่างต่อไปนี้
- ข้อความฉบับร่างต้องไม่มีป้ายกำกับอื่นนอกเหนือจากป้ายกำกับระบบ
DRAFT - เมื่อส่งฉบับร่าง ระบบจะลบฉบับร่างโดยอัตโนมัติและสร้างข้อความใหม่
พร้อมรหัสที่อัปเดตโดยใช้
SENTป้ายกำกับของระบบ ข้อความนี้จะแสดงในคำตอบของเมธอดdrafts.send
สร้างฉบับร่าง
แอปของคุณสร้างฉบับร่างได้โดยใช้เมธอด
drafts.create
วิธีสร้างฉบับร่าง
- สร้างข้อความ MIME ที่เป็นไปตาม RFC 2822
- แปลงข้อความเป็นสตริงที่เข้ารหัส Base64URL
- เรียกใช้เมธอด
drafts.createโดยตั้งค่าฟิลด์messages.rawเป็นสตริงที่เข้ารหัส
ตัวอย่างโค้ดต่อไปนี้แสดงกระบวนการ
Java
Python
cURL
curl --request POST \
'https://gmail.googleapis.com/gmail/v1/users/me/drafts' \
--header 'Authorization: Bearer ACCESS_TOKEN" \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{"message":{"raw":"MESSAGE"}}'
แทนที่ค่าต่อไปนี้
- ACCESS_TOKEN: โทเค็นการเข้าถึงที่ให้สิทธิ์เข้าถึง API
- MESSAGE: ข้อความ MIME ที่จัดรูปแบบตาม RFC 2822 เข้ารหัสเป็น base64URL
อัปเดตฉบับร่าง
เช่นเดียวกับการสร้างฉบับร่าง หากต้องการอัปเดตฉบับร่าง คุณต้องระบุdrafts
ทรัพยากรในเนื้อหาของคำขอโดยตั้งค่าฟิลด์ messages.raw เป็นสตริงที่เข้ารหัส base64URL ซึ่งมีข้อความ MIME เนื่องจากอัปเดตข้อความไม่ได้ ระบบจึงทำลายข้อความในฉบับร่างและแทนที่ด้วยข้อความ MIME ใหม่ที่ระบุในคำขออัปเดต
คุณสามารถดึงข้อความ MIME ปัจจุบันที่อยู่ในฉบับร่างได้โดยการเรียกใช้เมธอด
drafts.get
ด้วยพารามิเตอร์การค้นหา format=raw
ดูข้อมูลเพิ่มเติมได้ที่วิธี
drafts.update
ส่งฉบับร่าง
เมื่อส่งฉบับร่าง คุณจะส่งตามที่เป็นอยู่หรือจะอัปเดตใน คำขอส่งก็ได้
หากต้องการอัปเดตฉบับร่างเมื่อส่ง ให้ระบุทรัพยากร drafts ในเนื้อหาคำขอ
ของเมธอด drafts.send
ในdraftsทรัพยากร คุณต้องระบุฉบับร่าง
idของ
ฉบับร่างที่จะส่ง และตั้งค่าฟิลด์ messages.raw เป็นข้อความ MIME ใหม่
ที่เข้ารหัสเป็นสตริง base64URL
ดูข้อมูลเกี่ยวกับการส่งข้อความ Gmail ได้ที่หัวข้อส่งข้อความ