MCP Tools Reference: gmailmcp.googleapis.com

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

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

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

ตัวอย่างต่อไปนี้แสดงวิธีใช้ curl เพื่อเรียกใช้เครื่องมือ search_threads 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": "search_threads",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

สคีมาอินพุต

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

SearchThreadsRequest

การแสดง JSON 
{

  "pageSize": integer

  "pageToken": string

  "query": string

  "includeTrash": boolean
}
ช่อง

ฟิลด์ Union _page_size

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

integer

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

ฟิลด์ Union _page_token

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

string

ไม่บังคับ โทเค็นหน้าเว็บเพื่อดึงข้อมูลหน้าผลลัพธ์ที่เฉพาะเจาะจงในรายการ เว้นว่างไว้เพื่อดึงข้อมูลหน้าแรก

ฟิลด์ Union _query

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

string

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

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

ฟิลด์ Union _include_trash

_include_trash ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
includeTrash

boolean

ไม่บังคับ รวมฉบับร่างจากโฟลเดอร์ถังขยะไว้ในผลการค้นหา ค่าเริ่มต้นคือ false

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

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

SearchThreadsResponse

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

object (Thread)

รายการข้อมูลสรุปของชุดข้อความ
nextPageToken

string

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

ชุดข้อความ

การแสดง JSON 
{
  "id": string,
  "messages": [
    {
      object (Message)
    }
  ]
}
ช่อง
id

string

ตัวระบุที่ไม่ซ้ำกันของเธรด
messages[]

object (Message)

รายการข้อความในชุดข้อความที่จัดเรียงตามลำดับเวลา

ข้อความ

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

string

ตัวระบุที่ไม่ซ้ำกันของข้อความ
snippet

string

ข้อมูลโค้ดของเนื้อความ
subject

string

เรื่องของข้อความที่ดึงมาจากส่วนหัว
sender

string

อีเมลของผู้ส่ง
toRecipients[]

string

ไปยังอีเมลของผู้รับ
ccRecipients[]

string

อีเมลของผู้รับในสำเนา
date

string

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

string

เนื้อหาข้อความแบบเต็ม จะแสดงก็ต่อเมื่อ MessageFormat เป็น FULL_CONTENT เท่านั้น

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

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