MCP Tools Reference: sheetsmcp.googleapis.com

टूल: get_spreadsheet

यह दी गई स्प्रेडशीट का कॉन्टेंट दिखाता है. यह दी गई स्प्रेडशीट के आईडी के लिए, टाइटल, शीट के नाम, ग्रिड की प्रॉपर्टी, और अन्य मेटाडेटा दिखाता है. अनुरोध करने पर, यह पूरी ग्रिड का डेटा भी दिखाता है. यह REST API में spreadsheets.get से जुड़ा है: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/get

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

Curl का अनुरोध 
curl --location 'https://sheetsmcp.googleapis.com/mcp' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "get_spreadsheet",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

इनपुट स्कीमा

GetContentRequest

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

string

ज़रूरी है. अनुरोध की जाने वाली स्प्रेडशीट का आईडी.
includeGridData

boolean

अगर ग्रिड का डेटा दिखाना है, तो 'सही' वैल्यू सेट करें.

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

यह JSON ऑब्जेक्ट को दिखाता है.

यह बिना क्रम वाला कुंजी-वैल्यू मैप है. इसका मकसद, JSON ऑब्जेक्ट के सिमैंटिक्स को पूरी तरह से कैप्चर करना है. इससे, ProtoJSON फ़ॉर्मैट में किसी भी JSON पेलोड को मैसेज फ़ील्ड के तौर पर पार्स किया जा सकता है.

यह इंटरऑपरेबल JSON के लिए, RFC 8259 के दिशा-निर्देशों का पालन करता है. खास तौर पर, इस टाइप में Int64 की बड़ी वैल्यू या NaN/Infinity नंबर नहीं दिखाए जा सकते. इसकी वजह यह है कि JSON फ़ॉर्मैट आम तौर पर, अपने नंबर टाइप में इन वैल्यू को सपोर्ट नहीं करता.

अगर आपको अपने मैसेज में किसी भी JSON को पार्स नहीं करना है, तो इस टाइप का इस्तेमाल करने के बजाय, कस्टम टाइप वाले मैसेज का इस्तेमाल करना बेहतर है.

स्ट्रक्ट

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

map (key: string, value: value (Value format))

डाइनैमिक तौर पर टाइप की गई वैल्यू का बिना क्रम वाला मैप.

यह एक ऐसा ऑब्जेक्ट है जिसमें "key": value पेयर की सूची होती है. उदाहरण: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

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

string
value

value (Value format)

मान

JSON के काेड में दिखाना 
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
फ़ील्ड
यूनियन फ़ील्ड kind. वैल्यू किस तरह की है. kind की वैल्यू इनमें से कोई एक हो सकती है:
nullValue

null

यह JSON null को दिखाता है.
numberValue

number

यह JSON नंबर को दिखाता है. यह NaN, Infinity या -Infinity नहीं होना चाहिए, क्योंकि JSON में इन्हें सपोर्ट नहीं किया जाता. यह Int64 की बड़ी वैल्यू भी नहीं दिखा सकता, क्योंकि JSON फ़ॉर्मैट आम तौर पर, अपने नंबर टाइप में इन्हें सपोर्ट नहीं करता.
stringValue

string

यह JSON स्ट्रिंग को दिखाता है.
boolValue

boolean

यह JSON बूलियन (true या JSON में false लिटरल) को दिखाता है.
structValue

object (Struct format)

यह JSON ऑब्जेक्ट को दिखाता है.
listValue

array (ListValue format)

यह JSON कलेक्शन को दिखाता है.

ListValue

JSON के काेड में दिखाना 
{
  "values": [
    value
  ]
}
फ़ील्ड
values[]

value (Value format)

डाइनैमिक तौर पर टाइप की गई वैल्यू का दोहराया गया फ़ील्ड.

NullValue

यह JSON null को दिखाता है.

NullValue एक सेंटिनल है. यह Value टाइप यूनियन के लिए, नल वैल्यू दिखाने के लिए सिर्फ़ एक वैल्यू वाले enum का इस्तेमाल करता है.

NullValue टाइप का कोई फ़ील्ड, 0 के अलावा कोई भी वैल्यू सेट होने पर अमान्य माना जाता है. ज़्यादातर ProtoJSON सीरियलाइज़र, इंटिजर वैल्यू के बावजूद, JSON null के तौर पर सेट की गई null_value के साथ Value को एमिट करेंगे. इसलिए, यह 0 वैल्यू पर दोतरफ़ा यात्रा करेगा.

Enums
NULL_VALUE नल वैल्यू.

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

डिस्ट्रक्टिव हिंट: ❌ | आइडमपोटेंट हिंट: ✅ | रीड-ओनली हिंट: ✅ | ओपन वर्ल्ड हिंट: ✅

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

इसके लिए, इनमें से किसी एक OAuth अनुमति की ज़रूरत होती है:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/spreadsheets.readonly
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets