MCP Tools Reference: gmailmcp.googleapis.com

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

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

เครื่องมือนี้สามารถกรองฉบับร่างตามสตริงการค้นหาและรองรับการแบ่งหน้า โดยจะแสดงรายการฉบับร่าง รวมถึงรหัสและเรื่อง คุณสามารถใช้ page_token เพื่อแบ่งหน้าผลลัพธ์ หากต้องการดึงข้อมูลผลลัพธ์ในหน้าถัดไป ให้ใช้ page_token ที่แสดงในคำตอบก่อนหน้า

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

คำขอ Curl 
curl --location 'https://gmailmcp.googleapis.com/mcp/v1' \
--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's 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 ครั้งก่อนเพื่อดึงข้อมูลผลลัพธ์ในหน้าถัดไป ปล่อยว่างไว้เพื่อดึงข้อมูลหน้าแรก โดยส่วนใหญ่จะใช้สำหรับการแบ่งหน้าเพื่อดึงข้อมูลผลลัพธ์ต่อจากที่การเรียก ListDraft ครั้งก่อนหยุดไว้ โดยเฉพาะอย่างยิ่งเมื่อจำนวนฉบับร่างที่ตรงกับคำค้นหาเกินขีดจำกัด page_size

ฟิลด์ Union _query

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

string

ตัวอย่าง: "subject:OneMCP Update" "from:gduser1@workspacesamples.dev" "to:gduser2@workspacesamples.dev AND newer_than:7d" "project proposal has:attachment" "is:unread"

การเว้นวรรคหรือเครื่องหมายขีดกลาง (-) จะเป็นการแยกหมายเลข ในขณะที่จุด (.) จะหมายถึงจุดทศนิยม เช่น 01.2047-100 ถือว่าเป็นตัวเลข 2 ชุด คือ 01.2047 และ 100

หมายเหตุ: หากต้องการให้ระบบแสดงฉบับร่างทั้งหมดสำหรับคำค้นหา เราสามารถแบ่งหน้าผลลัพธ์ได้โดยการเรียกเครื่องมือซ้ำๆ จนกว่าการตอบกลับจะมีรายการฉบับร่างว่างเปล่า

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

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

ListDraftsResponse

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

object (Draft)

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

string

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

ฉบับร่าง

การแสดง 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)

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

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