MCP Tools Reference: sheetsmcp.googleapis.com

टूल: update_spreadsheet

यह स्प्रेडशीट में एक या उससे ज़्यादा अपडेट लागू करता है.

यह REST API में spreadsheets.batchUpdate से मेल खाता है: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/batchUpdate

अपडेट की जा सकने वाली जानकारी की सूची यहां दी गई है:

  • updateSpreadsheetProperties: स्प्रेडशीट की प्रॉपर्टी अपडेट करता है.
  • updateSheetProperties: इस फ़ंक्शन का इस्तेमाल करके, किसी शीट की प्रॉपर्टी अपडेट की जाती हैं.
  • updateDimensionProperties: डाइमेंशन की प्रॉपर्टी अपडेट करता है.
  • updateNamedRange: नाम वाली रेंज को अपडेट करता है.
  • repeatCell: यह फ़ंक्शन, किसी रेंज में मौजूद किसी सेल को दोहराता है.
  • addNamedRange: इससे नाम वाली रेंज जोड़ी जाती है.
  • deleteNamedRange: नाम वाली रेंज मिटाता है.
  • addSheet: इससे एक नई शीट जुड़ जाती है.
  • deleteSheet: किसी शीट को मिटाता है.
  • autoFill: मौजूदा डेटा के आधार पर, ज़्यादा डेटा अपने-आप भर जाता है.
  • cutPaste: यह सुविधा, डेटा को एक जगह से काटकर दूसरी जगह चिपकाती है.
  • copyPaste: यह फ़ंक्शन, डेटा को एक जगह से कॉपी करके दूसरी जगह पर चिपकाता है.
  • mergeCells: इससे सेल मर्ज हो जाती हैं.
  • unmergeCells: मर्ज की गई सेल को अनमर्ज करता है.
  • updateBorders: यह फ़ंक्शन, सेल की किसी रेंज में मौजूद बॉर्डर को अपडेट करता है.
  • updateCells: एक साथ कई सेल अपडेट करता है.
  • addFilterView: इससे फ़िल्टर व्यू जोड़ा जाता है.
  • appendCells: यह विकल्प चुनने पर, शीट में डेटा वाली आखिरी लाइन के बाद सेल जुड़ जाते हैं.
  • clearBasicFilter: इससे किसी शीट पर मौजूद बुनियादी फ़िल्टर हट जाता है.
  • deleteDimension: किसी शीट में मौजूद पंक्तियों या कॉलम को मिटाता है.
  • deleteEmbeddedObject: यह फ़ंक्शन, किसी शीट में एम्बेड किए गए ऑब्जेक्ट (जैसे, चार्ट, इमेज) को मिटाता है.
  • deleteFilterView: इस फ़ंक्शन का इस्तेमाल करके, किसी शीट से फ़िल्टर व्यू मिटाया जा सकता है.
  • duplicateFilterView: फ़िल्टर व्यू की डुप्लीकेट कॉपी बनाता है.
  • duplicateSheet: किसी शीट का डुप्लीकेट बनाता है.
  • findReplace: इस फ़ंक्शन की मदद से, किसी टेक्स्ट को खोजकर उसकी जगह पर दूसरा टेक्स्ट डाला जा सकता है.
  • insertDimension: इस फ़ंक्शन की मदद से, किसी शीट में नई पंक्तियां या कॉलम जोड़े जा सकते हैं.
  • insertRange: इस फ़ंक्शन की मदद से, शीट में नई सेल डाली जाती हैं. साथ ही, मौजूदा सेल को दूसरी जगह ले जाया जाता है.
  • moveDimension: इस फ़ंक्शन की मदद से, किसी शीट में मौजूद लाइनों या कॉलम को दूसरी जगह ले जाया जा सकता है.
  • updateEmbeddedObjectPosition: इससे एम्बेड किए गए ऑब्जेक्ट (जैसे कि चार्ट, इमेज) की पोज़िशन अपडेट होती है.
  • pasteData: इस फ़ंक्शन का इस्तेमाल करके, किसी शीट में डेटा (एचटीएमएल या सीमांकक वाला) चिपकाया जाता है.
  • textToColumns: टेक्स्ट के किसी कॉलम को टेक्स्ट के कई कॉलम में बदलता है.
  • updateFilterView: फ़िल्टर व्यू की प्रॉपर्टी अपडेट करता है.
  • deleteRange: किसी शीट से सेल की रेंज मिटाता है और बाकी सेल को शिफ़्ट करता है.
  • appendDimension: डाइमेंशन को किसी शीट के आखिर में जोड़ता है.
  • addConditionalFormatRule: इससे शर्त के साथ फ़ॉर्मैटिंग का नया नियम जोड़ा जाता है.
  • updateConditionalFormatRule: इससे शर्त के साथ फ़ॉर्मैटिंग के मौजूदा नियम को अपडेट किया जाता है.
  • deleteConditionalFormatRule: यह फ़ंक्शन, शर्त के साथ फ़ॉर्मैटिंग के मौजूदा नियम को मिटाता है.
  • sortRange: किसी रेंज में मौजूद डेटा को क्रम से लगाता है.
  • setDataValidation: एक या उससे ज़्यादा सेल के लिए, डेटा की पुष्टि करने की सुविधा सेट करता है.
  • setBasicFilter: किसी शीट पर बुनियादी फ़िल्टर सेट करता है.
  • addProtectedRange: सुरक्षित की गई रेंज जोड़ता है.
  • updateProtectedRange: सुरक्षित की गई रेंज को अपडेट करता है.
  • deleteProtectedRange: सुरक्षित की गई रेंज मिटाता है.
  • autoResizeDimensions: यह फ़ंक्शन, डाइमेंशन में मौजूद सेल के कॉन्टेंट के आधार पर, एक या उससे ज़्यादा डाइमेंशन का साइज़ अपने-आप बदल देता है.
  • addChart: इससे चार्ट जोड़ा जाता है.
  • updateChartSpec: इससे चार्ट की खास बातों को अपडेट किया जाता है.
  • updateBanding: बैंड की गई रेंज को अपडेट करता है
  • addBanding: इससे नई बैंडेड रेंज जोड़ी जाती है
  • deleteBanding: बैंड की गई रेंज को हटाता है
  • createDeveloperMetadata: नया डेवलपर मेटाडेटा बनाता है
  • updateDeveloperMetadata: यह मौजूदा डेवलपर मेटाडेटा एंट्री को अपडेट करता है
  • deleteDeveloperMetadata: डेवलपर मेटाडेटा मिटाता है
  • randomizeRange: यह फ़ंक्शन, किसी रेंज में मौजूद लाइनों के क्रम को बदल देता है.
  • addDimensionGroup: इससे तय की गई रेंज के हिसाब से ग्रुप बनता है.
  • deleteDimensionGroup: इस फ़ंक्शन का इस्तेमाल, तय की गई रेंज में मौजूद ग्रुप को मिटाने के लिए किया जाता है.
  • updateDimensionGroup: इससे चुने गए ग्रुप का स्टेटस अपडेट होता है.
  • trimWhitespace: यह फ़ंक्शन, सेल में मौजूद ग़ैर-ज़रूरी व्हाइटस्पेस (जैसे कि स्पेस, टैब या नई लाइनें) को हटाता है.
  • deleteDuplicates: यह फ़ंक्शन, सेल की किसी रेंज के चुने गए कॉलम में मौजूद डुप्लीकेट वैल्यू वाली पंक्तियों को हटाता है.
  • updateEmbeddedObjectBorder: इससे एम्बेड किए गए ऑब्जेक्ट के बॉर्डर को अपडेट किया जाता है.
  • addSlicer: स्लाइसर जोड़ता है.
  • updateSlicerSpec: स्लाइसर की खास जानकारी अपडेट करता है.
  • addDataSource: इससे डेटा सोर्स जोड़ा जाता है.
  • updateDataSource: इससे डेटा सोर्स अपडेट होता है.
  • deleteDataSource: इससे डेटा सोर्स मिट जाता है.
  • refreshDataSource: इससे एक या एक से ज़्यादा डेटा सोर्स और उनसे जुड़े dbobject रीफ़्रेश होते हैं.
  • cancelDataSourceRefresh: इससे एक या एक से ज़्यादा डेटा सोर्स और उनसे जुड़े dbobject के रीफ़्रेश होने की प्रोसेस रद्द हो जाती है.
  • addTable: इससे टेबल जोड़ी जाती है.
  • updateTable: किसी टेबल को अपडेट करता है.
  • deleteTable: टेबल मिटाने का अनुरोध.

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

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

इनपुट स्कीमा

UpdateContentRequest

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

string

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

object (Struct format)

ज़रूरी है. स्प्रेडशीट में लागू किए जाने वाले अपडेट की सूची. हर अनुरोध, spreadsheets.batchUpdate का मान्य अनुरोध ऑब्जेक्ट होना चाहिए. इसके लिए, इस दस्तावेज़ में दिए गए स्कीमा का इस्तेमाल करें: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/request अनुरोधों को उसी क्रम में लागू किया जाएगा जिस क्रम में उन्हें तय किया गया है. अगर कोई अनुरोध मान्य नहीं है, तो कोई भी अनुरोध लागू नहीं किया जाएगा.

स्ट्रक्ट

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 शून्य वैल्यू.

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

यह एक 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 शून्य वैल्यू.

टूल एनोटेशन

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

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

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

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