MCP Tools Reference: gmailmcp.googleapis.com

เครื่องมือ: create_draft

สร้างอีเมลฉบับร่างใหม่ในบัญชี Gmail ของผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์

เครื่องมือนี้จะรับอีเมลผู้รับ เรื่อง และเนื้อหาเป็นข้อมูลนำเข้า หากสร้างฉบับร่างเป็นการตอบกลับข้อความที่มีอยู่ คุณควรส่งรหัสของข้อความต้นฉบับไปยังเครื่องมือในช่อง replyToMessageId

แสดงเฉพาะรหัสที่ไม่ซ้ำกัน (id) ของข้อความฉบับร่าง

ข้อจำกัด: ระบบยังไม่รองรับการสร้างฉบับร่างที่มีไฟล์แนบ

ตัวอย่างต่อไปนี้แสดงวิธีใช้ curl เพื่อเรียกใช้เครื่องมือ create_draft MCP

คำขอ Curl 
curl --location 'https://gmailmcp.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "create_draft",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

สคีมาอินพุต

ข้อความคำขอสำหรับ RPC CreateDraft

CreateDraftRequest

การแสดง JSON 
{
  "to": [
    string
  ],
  "cc": [
    string
  ],
  "bcc": [
    string
  ],
  "subject": string,
  "body": string,
  "htmlBody": string,
  "replyToMessageId": string,
  "attachments": [
    {
      object (Attachment)
    }
  ]
}
ฟิลด์
to[]

string

ไม่บังคับ ผู้รับหลักของฉบับร่างอีเมล สตริงแต่ละรายการต้องเป็นอีเมลธรรมดาที่ถูกต้อง (เช่น "user@example.com") เครื่องมือนี้ไม่รองรับรูปแบบ "ชื่อ email@example.com"
cc[]

string

ไม่บังคับ ผู้รับสำเนาถึงของฉบับร่างอีเมล สตริงแต่ละรายการต้องเป็นอีเมลธรรมดาที่ถูกต้อง (เช่น "user@example.com") เครื่องมือนี้ไม่รองรับรูปแบบ "ชื่อ email@example.com"
bcc[]

string

ไม่บังคับ ผู้รับสำเนาลับของฉบับร่างอีเมล สตริงแต่ละรายการต้องเป็นอีเมลธรรมดาที่ถูกต้อง (เช่น "user@example.com") เครื่องมือนี้ไม่รองรับรูปแบบ "ชื่อ email@example.com"
subject

string

ไม่บังคับ บรรทัดเรื่องของอีเมล ค่าเริ่มต้นจะเป็นค่าว่างหากไม่ได้ระบุไว้
body

string

ไม่บังคับ เนื้อหาหลักของฉบับร่างอีเมล หากระบุ html_body ด้วย ระบบจะถือว่าฟิลด์นี้เป็นข้อความธรรมดาแทน
htmlBody

string

เนื้อหา HTML ของอีเมลฉบับร่าง หากระบุไว้ ระบบจะใช้อีเมลนี้เป็นเวอร์ชันข้อความที่จัดรูปแบบแล้ว
replyToMessageId

string

ไม่บังคับ รหัสของข้อความที่จะตอบกลับ หากระบุไว้ ระบบจะใช้รหัสข้อความตอบกลับสำหรับอีเมลฉบับร่าง และจะต่อท้าย body และ html_body ไว้กับเนื้อหาข้อความเดิม
attachments[]

object (Attachment)

ไม่บังคับ ไฟล์แนบที่จะรวมไว้ในอีเมล ขนาดไฟล์แนบรวมกันในข้อความต้องไม่เกิน 25 MB หากต้องการส่งไฟล์ที่มีขนาดใหญ่กว่า 25 MB ให้อัปโหลดไฟล์ไปยังไดรฟ์ก่อน แล้วแทรกลิงก์ไดรฟ์ลงในเนื้อหาหรือ html_body

ไฟล์แนบ

การแสดง JSON 
{
  "id": string,
  "filename": string,
  "mimeType": string,
  "content": string,
  "inline": boolean
}
ฟิลด์
id

string

ไม่บังคับ เอาต์พุตเท่านั้น หากมี จะมีรหัสของไฟล์แนบภายนอกที่ดึงข้อมูลได้ในGetMessageAttachmentคำขอแยกต่างหาก
filename

string

ไม่บังคับ ชื่อไฟล์ที่จะแนบ เช่น "invoice.pdf" สำหรับไฟล์แนบแบบอินไลน์ ระบบจะใช้ค่านี้ในการสร้าง Content-ID สำหรับไฟล์แนบปกติ ระบบจะใช้ชื่อไฟล์เพื่อระบุชื่อไฟล์ให้กับโปรแกรมรับส่งอีเมล หากไม่ได้ระบุชื่อ ระบบอาจรับไฟล์แนบโดยไม่มีชื่อ
mimeType

string

ไม่บังคับ ฟิลด์ที่แสดงประเภทเนื้อหาหรือสื่อต้องใช้ประเภท MIME ของ IANA, https://www.iana.org/assignments/media-types/media-types.xhtml หากไม่ได้ระบุ ค่าเริ่มต้นจะเป็น "application/octet-stream"
content

string (bytes format)

ต้องระบุ เนื้อหาของไฟล์แนบที่เข้ารหัส Base64

สตริงที่เข้ารหัส Base64
inline

boolean

ไม่บังคับ หากเป็นจริง ระบบจะจัดการไฟล์แนบนี้เป็นแบบอินไลน์ ไฟล์แนบแบบอินไลน์คือเนื้อหาที่มีไว้เพื่อแสดงภายในเนื้อหาของอีเมล HTML ซึ่งแตกต่างจากการแสดงเป็นไฟล์แยกต่างหากสำหรับการดาวน์โหลด หากเป็นเท็จหรือไม่มีอยู่ ระบบจะตั้งค่าเริ่มต้นเป็นเท็จและถือว่าเป็นไฟล์แนบปกติ

สคีมาเอาต์พุต

รายละเอียดของฉบับร่าง

ฉบับร่าง

การแสดง JSON 
{
  "id": string,
  "subject": string,
  "threadId": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "bccRecipients": [
    string
  ],
  "plaintextBody": string,
  "date": string,
  "htmlBody": string
}
ช่อง
id

string

ตัวระบุที่ไม่ซ้ำกันของทรัพยากรฉบับร่าง
subject

string

บรรทัดหัวเรื่องของข้อความฉบับร่าง
threadId

string

รหัสของเธรดที่ฉบับร่างนี้เป็นของ
toRecipients[]

string

รายการอีเมลของผู้รับในช่อง "ถึง" ที่ดึงมาจากส่วนหัว
ccRecipients[]

string

รายการอีเมลของผู้รับ "สำเนา" ที่ดึงมาจากส่วนหัว
bccRecipients[]

string

รายการอีเมลของผู้รับ "สำเนาลับ" ที่ดึงมาจากส่วนหัว
plaintextBody

string

เนื้อหาข้อความธรรมดา หากมี
date

string

วันที่ของฉบับร่างในรูปแบบ ISO 8601 (YYYY-MM-DD)
htmlBody

string

เนื้อหาในส่วนเนื้อหา HTML ของฉบับร่าง หากมี

คำอธิบายประกอบเครื่องมือ

คำแนะนำที่ทำให้เกิดการทำลาย: ❌ | คำแนะนำที่ทำให้เกิดการดำเนินการซ้ำ: ❌ | คำแนะนำแบบอ่านอย่างเดียว: ❌ | คำแนะนำแบบโลกเปิด: ❌

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.compose