MCP Tools Reference: sheetsmcp.googleapis.com

टूल: update_values

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

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

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

इनपुट स्कीमा

UpdateValuesRequest

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

string

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

string

ज़रूरी है. अपडेट की जाने वाली वैल्यू का A1 नोटेशन.
values[]

array (ListValue format)

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

ListValue

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

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 बूलियन (JSON में true या 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 सीरियललाइज़र, Value को JSON null के तौर पर सेट करके null_value को जारी करेंगे. इससे कोई फ़र्क़ नहीं पड़ता कि पूर्णांक की वैल्यू क्या है. इसलिए, यह 0 वैल्यू पर राउंड ट्रिप करेगा.

Enums
NULL_VALUE शून्य वैल्यू.

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

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

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

यह इंटरऑपरेबल 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 बूलियन (JSON में true या 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 सीरियललाइज़र, Value को JSON null के तौर पर सेट करके null_value को जारी करेंगे. इससे कोई फ़र्क़ नहीं पड़ता कि पूर्णांक की वैल्यू क्या है. इसलिए, यह 0 वैल्यू पर राउंड ट्रिप करेगा.

Enums
NULL_VALUE शून्य वैल्यू.

टूल एनोटेशन

बदलाव करने वाला सुझाव: ❌ | एक ही बार लागू होने वाला सुझाव: ❌ | सिर्फ़ पढ़ने के लिए सुझाव: ❌ | ओपन वर्ल्ड सुझाव: ✅