این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

MCP Tools Reference: gmailmcp.googleapis.com

ابزار: `create_draft`

یک ایمیل پیش‌نویس جدید در حساب جیمیل کاربر احراز هویت‌شده ایجاد می‌کند.

این ابزار آدرس‌های گیرنده، موضوع و محتوای اصلی ایمیل را به عنوان ورودی دریافت می‌کند و شناسه پیش‌نویس جیمیل ایجاد شده را برمی‌گرداند.

نمونه زیر نحوه استفاده از curl برای فراخوانی ابزار create_draft MCP را نشان می‌دهد.

درخواست کرل
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": "create_draft", "arguments": { // provide these details according to the tool MCP specification } }, "jsonrpc": "2.0", "id": 1 }'

درخواست کرل

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": "create_draft",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

طرحواره ورودی

درخواست پیام برای CreateDraft RPC.

درخواست ایجاد پیش‌نویس

نمایش JSON
{ "to": [ string ], "cc": [ string ], "bcc": [ string ], "subject": string, "body": string, "htmlBody": string }

فیلدها
`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 پیش‌نویس ایمیل. در صورت ارائه، این به عنوان نسخه متن غنی ایمیل استفاده خواهد شد.

طرحواره خروجی

جزئیات یک پیش‌نویس

پیش نویس

نمایش 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` فهرست آدرس‌های ایمیل گیرنده «Cc» که از سربرگ‌ها استخراج شده‌اند.
`bccRecipients[]`	`string` فهرست آدرس‌های ایمیل گیرنده «Bcc» که از سربرگ‌ها استخراج شده‌اند.
`plaintextBody`	`string` متن ساده‌ی محتوای بدنه، در صورت وجود.
`date`	`string` تاریخ پیش‌نویس در قالب ISO 8601 (YYYY-MM-DD).

حاشیه‌نویسی ابزار

راهنمایی مخرب: ❌ | راهنمایی بی‌اثر: ❌ | راهنمایی فقط خواندنی: ❌ | راهنمایی جهان باز: ❌