MCP Tools Reference: gmailmcp.googleapis.com

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

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

เครื่องมือนี้สามารถกรองฉบับร่างตามสตริงการค้นหาและรองรับการแบ่งหน้า โดยจะแสดงรายการฉบับร่าง รวมถึงรหัสและเรื่องของฉบับร่าง

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

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

สคีมาอินพุต

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

ListDraftsRequest

การแสดง JSON 
{

  "pageSize": integer

  "pageToken": string

  "query": string
}
ช่อง

ฟิลด์ Union _page_size

_page_size สามารถเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
pageSize

integer

ไม่บังคับ จำนวนฉบับร่างสูงสุดที่จะแสดง หากไม่ระบุ ระบบจะใช้ค่าเริ่มต้นเป็น 20 ค่าสูงสุดที่อนุญาตคือ 50

ฟิลด์ Union _page_token

_page_token สามารถเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
pageToken

string

ไม่บังคับ โทเค็นที่ได้รับจากการเรียก list_drafts ครั้งก่อนหน้าเพื่อดึงผลลัพธ์หน้าถัดไป ปล่อยว่างไว้เพื่อดึงหน้าแรก

ฟิลด์ Union _query

_query สามารถเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
query

string

ไม่บังคับ สตริงการค้นหาเพื่อกรองฉบับร่าง โดยใช้รูปแบบเดียวกับการค้นหาใน Gmail หากไม่ระบุ ระบบจะแสดงฉบับร่างทั้งหมด (ไม่รวมสแปมและถังขยะโดยค่าเริ่มต้น) โอเปอเรเตอร์หลัก: from: - ข้อความจากผู้ส่งที่ระบุ to: - ข้อความที่ส่งไปยังผู้รับที่ระบุ subject: - ข้อความที่มีคำที่ระบุในเรื่อง - ข้อความที่มีคำที่ระบุในเนื้อหาหรือเรื่อง is:unread - ข้อความที่ยังไม่ได้อ่าน is:starred - ข้อความที่ติดดาว has:attachment - ข้อความที่มีไฟล์แนบ after:YYYY/MM/DD - ข้อความที่ส่งหลังจากวันที่ before:YYYY/MM/DD - ข้อความที่ส่งก่อนวันที่ newer_than:

 Examples:
 "subject:OneMCP Update"
 "from:gduser1@workspacesamples.dev"
 "to:gduser2@workspacesamples.dev AND newer_than:7d"
 "project proposal has:attachment"
 "is:unread"

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

ข้อความตอบกลับสำหรับ ListDrafts RPC

ListDraftsResponse

การแสดง JSON 
{
  "drafts": [
    {
      object (Draft)
    }
  ],
  "nextPageToken": string
}
ช่อง
drafts[]

object (Draft)

รายการฉบับร่าง
nextPageToken

string

โทเค็นที่ใช้ในการเรียกครั้งถัดไปเพื่อดึงฉบับร่างหน้าถัดไป จะปรากฏขึ้นก็ต่อเมื่อมีผลลัพธ์เพิ่มเติม

ฉบับร่าง

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

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

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