MCP Tools Reference: sheetsmcp.googleapis.com

टूल: get_values

यह स्प्रेडशीट से वैल्यू की रेंज दिखाता है. यह REST API में spreadsheets.values.get से मेल खाता है: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get

यहां दिए गए सैंपल में, get_values 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_values",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

इनपुट स्कीमा

GetValuesRequest

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

string

ज़रूरी है. यह उस स्प्रेडशीट का आईडी है जिससे डेटा पाना है.
range

string

ज़रूरी है. यह उस रेंज का A1 नोटेशन या R1C1 नोटेशन है जिससे वैल्यू पाने हैं.

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

स्प्रेडशीट की किसी रेंज में मौजूद डेटा. https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values

ValueRange

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

string

यह A1 नोटेशन में, वह रेंज है जिसमें वैल्यू शामिल हैं.
values[]

array (ListValue format)

यह वह डेटा है जिसे पढ़ा गया है. यह कलेक्शन का कलेक्शन है. इसमें, बाहरी कलेक्शन पूरे डेटा को दिखाता है. वहीं, हर अंदरूनी कलेक्शन एक लाइन को दिखाता है. अंदरूनी कलेक्शन में मौजूद हर आइटम, एक सेल से मेल खाता है. इसमें आखिर में मौजूद खाली लाइनों और कॉलम को शामिल नहीं किया जाएगा.

ListValue

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

value (Value format)

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

Value

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 कलेक्शन को दिखाता है.

स्ट्रक्ट

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)

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