"ร่างจดหมาย" คือข้อความที่ยังไม่ได้ส่งและใช้ป้ายกำกับของระบบ "DRAFT
" แล้ว
เมื่อสร้างข้อความฉบับร่างในฉบับร่างแล้วจะแก้ไขไม่ได้ แต่แทนที่ข้อความได้ ตามความหมายนี้ ทรัพยากรฉบับร่างเป็นเพียงคอนเทนเนอร์ที่มีรหัสแบบคงที่ เนื่องจากรหัสข้อความที่สำคัญจะเปลี่ยนแปลงทุกครั้งที่ข้อความถูกแทนที่
ทรัพยากรข้อความในข้อความร่างจะมีลักษณะการทำงานที่คล้ายกับข้อความอื่นๆ ยกเว้นข้อแตกต่างต่อไปนี้
- ข้อความร่างจะมีป้ายกำกับอื่นนอกจากป้ายกำกับของระบบ
DRAFT
ไม่ได้ - เมื่อส่งฉบับร่างแล้ว ระบบจะลบฉบับร่างนั้นโดยอัตโนมัติและจะสร้างข้อความใหม่ที่มีรหัสที่อัปเดตแล้วที่มีป้ายกำกับระบบ
SENT
ด้วย ข้อความนี้จะแสดงในการตอบสนองของdrafts.send
เนื้อหา
กำลังสร้างข้อความร่าง
แอปพลิเคชันสร้างฉบับร่างได้โดยใช้เมธอด drafts.create ขั้นตอนทั่วไปมีดังนี้
- สร้างข้อความ MIME ที่สอดคล้องกับ RFC 2822
- แปลงข้อความเป็นสตริงที่เข้ารหัส base64url
- สร้างฉบับร่าง โดยตั้งค่า
ช่อง
drafts.message.raw
เป็นสตริงที่เข้ารหัส
ตัวอย่างโค้ดต่อไปนี้จะแสดงกระบวนการ
Java
Python
การอัปเดตฉบับร่าง
ในทำนองเดียวกับการสร้างฉบับร่าง หากต้องการอัปเดตฉบับร่าง คุณต้องใส่ทรัพยากร Draft
ในส่วนเนื้อหาของคำขอ โดยตั้งค่าช่อง draft.message.raw
เป็นสตริงที่เข้ารหัส base64url ที่มีข้อความ MIME เนื่องจากไม่สามารถอัปเดตข้อความได้ ข้อความที่อยู่ในฉบับร่างจะถูกทำลายและแทนที่ด้วยข้อความ MIME ใหม่ที่ให้ไว้ในคำขออัปเดต
คุณเรียกดูข้อความ MIME ปัจจุบันที่มีอยู่ในฉบับร่างได้โดยเรียกใช้ drafts.get
ด้วยพารามิเตอร์ format=raw
ดูข้อมูลเพิ่มเติมได้ที่ drafts.update
การส่งฉบับร่าง
เมื่อส่งข้อความร่าง คุณสามารถเลือกส่งข้อความตามเดิมหรือตามข้อความที่อัปเดตแล้วก็ได้ หากคุณกำลังอัปเดตเนื้อหาฉบับร่างด้วยข้อความใหม่ ให้ส่งทรัพยากร Draft
ในส่วนเนื้อหาของคำขอ drafts.send
ตั้งค่า draft.id
ของฉบับร่างที่จะส่ง และตั้งค่าช่อง draft.message.raw
เป็นข้อความ MIME ใหม่ที่เข้ารหัสเป็นสตริงที่เข้ารหัสแบบ base64url ดูข้อมูลเพิ่มเติมได้ที่ drafts.send