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

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

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

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

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

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