MCP Tools Reference: drivemcp.googleapis.com

टूल: download_file_content

Drive में मौजूद किसी फ़ाइल के कॉन्टेंट को base64 कोड में बदली गई स्ट्रिंग के तौर पर डाउनलोड करने के लिए, इस टूल को कॉल करें.

अगर फ़ाइल, Google Drive के पहले पक्ष का माइम टाइप है, तो exportMimeType फ़ील्ड ज़रूरी है. इससे यह तय होगा कि डाउनलोड की गई फ़ाइल किस फ़ॉर्मैट में होगी.

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

अगर उपयोगकर्ता को Drive में मौजूद अपने कॉन्टेंट को नैचुरल लैंग्वेज में देखना है, तो read_file_content टूल का इस्तेमाल करें. read_file_content छोटा होना चाहिए और इसे आसानी से पार्स किया जा सके.

यहां दिए गए सैंपल में, curl का इस्तेमाल करके, download_file_content MCP टूल को कॉल करने का तरीका बताया गया है.

Curl का अनुरोध
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": "download_file_content",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'
                

इनपुट स्कीमा

इससे, किसी फ़ाइल का कॉन्टेंट डाउनलोड करने के अनुरोध के बारे में पता चलता है.

DownloadFileRequest

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

string

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

exportMimeType

string

ज़रूरी नहीं. Google की ओर से बनाई गई फ़ाइलों के लिए, यह एमआईएमई टाइप ज़रूरी है. इसकी मदद से, यह तय किया जाता है कि फ़ाइल किस फ़ॉर्मैट में एक्सपोर्ट की जाएगी. अन्य फ़ाइलों के लिए, यह एमआईएमई टाइप ज़रूरी नहीं है. अगर कोई वैल्यू नहीं दी जाती है, तो डिफ़ॉल्ट रूप से इसकी वैल्यू टेक्स्ट होती है.

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

यह, फ़ाइल डाउनलोड करने के अनुरोध का जवाब है.

FileContent

JSON के काेड में दिखाना
{
  "id": string,
  "title": string,
  "mimeType": string,
  "content": string
}
फ़ील्ड
id

string

फ़ाइल का आईडी.

title

string

फ़ाइल का टाइटल.

mimeType

string

फ़ाइल का एमआईएमई टाइप.

content

string

फ़ाइल का base64 कोड में बदला गया कॉन्टेंट.

टूल के एनोटेशन

डिस्ट्रक्टिव हिंट: ❌ | आइडमपोटेंट हिंट: ✅ | सिर्फ़ पढ़ने की अनुमति वाली हिंट: ✅ | ओपन वर्ल्ड हिंट: ❌

अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक 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