MCP Tools Reference: sheetsmcp.googleapis.com

टूल: insert_dimension

इस टूल की मदद से, किसी शीट में किसी खास इंडेक्स पर पंक्तियां या कॉलम जोड़े जा सकते हैं. यह टूल, spreadsheets.batchUpdate REST API में मौजूद InsertDimensionRequest से जुड़ा है: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/request

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

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": "insert_dimension",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

इनपुट स्कीमा

InsertDimensionRequest

JSON फ़ॉर्मैट में दिखाया गया है 
{
  "spreadsheetId": string,
  "sheetId": integer,
  "dimension": enum (Dimension),
  "startIndex": integer,
  "endIndex": integer,
  "inheritFromBefore": boolean
}
फ़ील्ड
spreadsheetId

string

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

integer

ज़रूरी है. जिस शीट में पंक्तियां या कॉलम जोड़ने हैं उसका आईडी.
dimension

enum (Dimension)

ज़रूरी है. जिस डाइमेंशन को जोड़ना है.
startIndex

integer

ज़रूरी है. इंसर्शन का 0-आधारित शुरुआती इंडेक्स (शामिल है).
endIndex

integer

ज़रूरी है. इंसर्शन का 0-आधारित आखिरी इंडेक्स (शामिल नहीं है).
inheritFromBefore

boolean

क्या डाइमेंशन की प्रॉपर्टी, नई जोड़ी गई डाइमेंशन से पहले या बाद वाले डाइमेंशन से बढ़ाई जानी चाहिए. पहले वाले डाइमेंशन से बढ़ाने के लिए, true. इस मामले में, शुरुआती इंडेक्स 0 से ज़्यादा होना चाहिए. बाद वाले डाइमेंशन से बढ़ाने के लिए, false.

डाइमेंशन

इससे पता चलता है कि किसी कार्रवाई को किस डाइमेंशन पर लागू किया जाना चाहिए.

Enums
DIMENSION_UNSPECIFIED डिफ़ॉल्ट वैल्यू. इसका इस्तेमाल न करें.
COLUMNS किसी शीट के कॉलम पर काम करता है.
ROWS किसी शीट की पंक्तियों पर काम करता है.

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

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

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

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