MCP Tools Reference: drivemcp.googleapis.com

ابزار: read_file_content

این ابزار را برای دریافت نمایش زبان طبیعی یک فایل Drive و در صورت تمایل، نظرات آن فراخوانی کنید.

محتوای فایل ممکن است برای فایل‌های بسیار بزرگ ناقص باشد. نمایش متن با گذشت زمان تغییر خواهد کرد، بنابراین در مورد قالب خاص متن برگردانده شده توسط این ابزار فرضیه‌سازی نکنید. در صورت پشتیبانی، برچسب‌های نظر در محتوا گنجانده خواهند شد.

انواع Mime پشتیبانی شده:

  • application/vnd.google-apps.document
  • application/vnd.google-apps.presentation
  • application/vnd.google-apps.spreadsheet
  • application/pdf
  • application/msword
  • application/vnd.openxmlformats-officedocument.wordprocessingml.document
  • application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
  • application/vnd.openxmlformats-officedocument.presentationml.presentation
  • application/vnd.oasis.opendocument.spreadsheet
  • application/vnd.oasis.opendocument.presentation
  • application/x-vnd.oasis.opendocument.text
  • image/png
  • image/jpeg
  • image/jpg

اگر فایل پیدا نشد، سعی کنید از ابزارهای دیگری مانند search_files برای یافتن فایلی که کاربر درخواست کرده است با استفاده از کلمات کلیدی استفاده کنید.

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

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

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

درخواست خواندن محتوای فایل با پشتیبانی از دریافت نظرات.

درخواست محتوای فایل خوانده شده

نمایش JSON 
{
  "fileId": string,
  "includeComments": boolean
}
فیلدها
fileId

string

الزامی. شناسه فایلی که قرار است بازیابی شود.

includeComments

boolean

آیا نظرات در پاسخ گنجانده شوند یا خیر. نظرات در محتوای متنی فایل با نگاشت به رشته‌های نظرات، به صورت درون‌خطی نمایش داده می‌شوند.

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

پاسخ به خواندن محتوای فایل.

پاسخ محتوای فایل را بخوانید

نمایش JSON 
{
  "contentAnchoredComments": [
    {
      object (CommentThread)
    }
  ],
  "unanchoredComments": [
    {
      object (CommentThread)
    }
  ],

  "fileContent": string

  "textFormattingNotSupported": boolean
  // End of list of possible types for union field
  // _text_formatting_not_supported.

  "commentsNotSupported": boolean
}
فیلدها
contentAnchoredComments[]

object ( CommentThread )

رشته‌های نظر که در فایل_محتوای برگردانده شده ارجاع داده شده‌اند.

unanchoredComments[]

object ( CommentThread )

رشته‌هایی را که نمی‌توان به محتوای خاصی در فایل برگردانده شده متصل کرد، کامنت کنید.

_file_content .

_file_content فقط می‌تواند یکی از موارد زیر باشد:

fileContent

string

محتوای فایل درایو در قالب متن برگردانده می‌شود. اگر فایل از قالب‌بندی متن پشتیبانی نکند، ممکن است خالی باشد. اگر مقدار include_comments در درخواست true باشد، می‌تواند ارجاعات به کامنت را نیز شامل کند.

فیلد یونیون _text_formatting_not_supported .

_text_formatting_not_supported فقط می‌تواند یکی از موارد زیر باشد:

textFormattingNotSupported

boolean

آیا قالب‌بندی متن برای این فایل پشتیبانی می‌شود یا خیر. اگر درست باشد، file_content خالی خواهد بود.

فیلد اتحادیه _comments_not_supported .

_comments_not_supported فقط می‌تواند یکی از موارد زیر باشد:

commentsNotSupported

boolean

اینکه آیا برگرداندن نظرات برای این فایل پشتیبانی می‌شود یا خیر. فقط در صورتی ارائه می‌شود که include_comments در درخواست true باشد و نظرات پشتیبانی نشوند.

موضوع نظر

نمایش JSON 
{
  "replies": [
    {
      object (Post)
    }
  ],

  "commentId": string

  "status": enum (Status)

  "headPost": {
    object (Post)
  }
}
فیلدها
replies[]

object ( Post )

پاسخ‌ها به اولین پست در بخش نظرات.

فیلد اتحادیه _comment_id .

_comment_id فقط می‌تواند یکی از موارد زیر باشد:

commentId

string

شناسه‌ی رشته‌ی نظر. این همان شناسه‌ی نظر اولیه است.

فیلد اتحادیه _status .

_status فقط می‌تواند یکی از موارد زیر باشد:

status

enum ( Status )

وضعیت رشته نظرات.

_head_post .

_head_post فقط می‌تواند یکی از موارد زیر باشد:

headPost

object ( Post )

اولین پست در بخش نظرات.

پست

نمایش JSON 
{

  "postId": string

  "content": string

  "authorName": string

  "modifiedTime": string
}
فیلدها

فیلد اتحادیه _post_id .

_post_id فقط می‌تواند یکی از موارد زیر باشد:

postId

string

شناسه پست.

فیلد یونیون _content .

_content فقط می‌تواند یکی از موارد زیر باشد:

content

string

محتوای پست.

فیلد یونیون _author_name .

_author_name فقط می‌تواند یکی از موارد زیر باشد:

authorName

string

نام نویسنده پست.

فیلد اتحادیه _modified_time .

_modified_time فقط می‌تواند یکی از موارد زیر باشد:

modifiedTime

string ( Timestamp format)

آخرین باری که پست ویرایش شده است.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

مهر زمانی

نمایش JSON 
{
  "seconds": string,
  "nanos": integer
}
فیلدها
seconds

string ( int64 format)

ثانیه‌های زمان UTC را از زمان یونیکس ۱۹۷۰-۰۱-۰۱T۰۰:۰۰:۰۰Z نشان می‌دهد. باید بین -۶۲۱۳۵۵۹۶۸۰۰ و ۲۵۳۴۰۲۳۰۰۷۹۹ باشد (که معادل ۰۰۰۱-۰۱-۰۱T۰۰:۰۰:۰۰Z تا ۹۹۹۹-۱۲-۳۱T۲۳:۵۹:۵۹Z است).

nanos

integer

کسرهای غیرمنفی ثانیه با وضوح نانوثانیه. این فیلد بخش نانوثانیه از مدت زمان است، نه جایگزینی برای ثانیه. مقادیر منفی ثانیه با کسرها باید همچنان دارای مقادیر نانوثانیه غیرمنفی باشند که در زمان به جلو شمارش می‌شوند. باید بین ۰ تا ۹۹۹۹۹۹۹۹۹۹ باشد.

وضعیت

وضعیت یک رشته نظر را تعریف می‌کند.

انوم‌ها
STATUS_UNSPECIFIED
OPEN
RESOLVED

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

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

دامنه‌های مجوز

به یکی از حوزه‌های OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly