MCP Tools Reference: drivemcp.googleapis.com

टूल: read_file_content

Drive फ़ाइल और उसकी टिप्पणियों को नैचुरल लैंग्वेज में दिखाने के लिए, इस टूल को कॉल करें.

बहुत बड़ी फ़ाइलों के लिए, फ़ाइल का कॉन्टेंट अधूरा हो सकता है. टेक्स्ट का फ़ॉर्मैट समय के साथ बदलता रहेगा. इसलिए, इस टूल से मिले टेक्स्ट के फ़ॉर्मैट के बारे में अनुमान न लगाएं. अगर सुविधा उपलब्ध है, तो कॉन्टेंट में टिप्पणी वाले टैग शामिल किए जाएंगे.

इस्तेमाल किए जा सकने वाले माइम टाइप:

  • 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 एमसीपी टूल को चालू करने का तरीका बताया गया है.

कर्ल अनुरोध 
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
}'

इनपुट स्कीमा

टिप्पणियां फ़ेच करने की सुविधा के साथ, फ़ाइल का कॉन्टेंट पढ़ने का अनुरोध.

ReadFileContentRequest

JSON के काेड में दिखाना 
{
  "fileId": string,
  "includeComments": boolean
}
फ़ील्ड
fileId

string

ज़रूरी है. उस फ़ाइल का आईडी जिसे वापस लाना है.
includeComments

boolean

जवाब में टिप्पणियां शामिल करनी हैं या नहीं. टिप्पणियां, फ़ाइल के टेक्स्ट कॉन्टेंट में इनलाइन की जाएंगी. साथ ही, उन्हें टिप्पणियों की थ्रेड से मैप किया जाएगा.

आउटपुट स्कीमा

फ़ाइल का कॉन्टेंट पढ़ने के लिए जवाब.

ReadFileContentResponse

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

Drive फ़ाइल का कॉन्टेंट, टेक्स्ट फ़ॉर्मैट में दिखता है. अगर फ़ाइल में टेक्स्ट फ़ॉर्मैटिंग की सुविधा काम नहीं करती है, तो यह खाली हो सकता है. अगर अनुरोध में include_comments को 'सही' के तौर पर सेट किया गया है, तो इसमें टिप्पणी के रेफ़रंस शामिल किए जा सकते हैं.

यूनियन फ़ील्ड _text_formatting_not_supported.

_text_formatting_not_supported इनमें से सिर्फ़ एक हो सकता है:
textFormattingNotSupported

boolean

इस फ़ाइल के लिए, टेक्स्ट फ़ॉर्मैटिंग की सुविधा उपलब्ध है या नहीं. अगर यह वैल्यू सही है, तो file_content खाली होगा.

यूनियन फ़ील्ड _comments_not_supported.

_comments_not_supported इनमें से सिर्फ़ एक हो सकता है:
commentsNotSupported

boolean

इस फ़ाइल के लिए, टिप्पणियों को वापस लाने की सुविधा काम करती है या नहीं. यह सिर्फ़ तब मौजूद होता है, जब अनुरोध में include_comments को सही पर सेट किया गया हो और टिप्पणियों की सुविधा काम न कर रही हो.

CommentThread

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)

पोस्ट में पिछली बार बदलाव कब किया गया था.

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "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)

यह Unix epoch 1970-01-01T00:00:00Z के बाद से यूटीसी समय के सेकंड को दिखाता है. यह -62135596800 और 253402300799 के बीच होना चाहिए. इसमें ये दोनों वैल्यू भी शामिल हैं. यह 0001-01-01T00:00:00Z से 9999-12-31T23:59:59Z के बीच की वैल्यू के बराबर होता है.
nanos

integer

नैनोसेकंड रिज़ॉल्यूशन पर, एक सेकंड के नॉन-नेगेटिव फ़्रैक्शन. यह फ़ील्ड, अवधि का नैनोसेकंड वाला हिस्सा है. यह सेकंड का विकल्प नहीं है. भिन्नात्मक वैल्यू वाली नेगेटिव सेकंड वैल्यू में, अब भी नॉन-नेगेटिव नैनो वैल्यू होनी चाहिए. इससे समय की गिनती आगे की ओर होती है. यह 0 और 99,99,99,999 के बीच होना चाहिए.

स्थिति

यह किसी टिप्पणी थ्रेड की स्थिति के बारे में बताता है.

Enums
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