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

स्कीमा: - spreadsheet_id (स्ट्रिंग, ज़रूरी है): अपडेट की जाने वाली स्प्रेडशीट का आईडी. - sheet_id (इंटीजर, ज़रूरी है): उस शीट का आईडी जिसमें डेटा डालना है. - dimension (स्ट्रिंग, ज़रूरी है): "ROWS" या "COLUMNS". - start_index (इंटीजर, ज़रूरी है): इंसर्ट करने के लिए, 0 से शुरू होने वाला इंडेक्स (शामिल है). - end_index (इंटीजर, ज़रूरी है): इंसर्ट किए गए आइटम का 0-आधारित एंड इंडेक्स (शामिल नहीं). - inherit_from_before (बूलियन, ज़रूरी नहीं): इससे यह तय होता है कि डाइमेंशन प्रॉपर्टी को पहले (true) या बाद (false) के डाइमेंशन से बढ़ाया जाना चाहिए या नहीं.

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

Curl अनुरोध 
curl --location 'https://sheetsmcp.googleapis.com/mcp/v1' \
--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 MCP tool 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 शीट की पंक्तियों पर काम करता है.

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

InsertDimensionResponse

JSON के काेड में दिखाना 
{
  "content": {
    object
  }
}
फ़ील्ड
content

object (Struct format)

Sheets API के JSON फ़ॉर्मैट में spreadsheets.batchUpdate रिस्पॉन्स और status फ़ील्ड.

स्ट्रक्ट

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 एक सेंटिनल है. यह सिर्फ़ एक वैल्यू वाले enum का इस्तेमाल करके, Value टाइप यूनियन के लिए शून्य वैल्यू दिखाता है.

NullValue टाइप के फ़ील्ड में 0 के अलावा कोई भी वैल्यू अमान्य मानी जाती है. ज़्यादातर ProtoJSON सीरियलाइज़र, पूर्णांक वैल्यू के बावजूद, JSON null के तौर पर सेट किए गए null_value के साथ Value को एमिट करेंगे. साथ ही, 0 वैल्यू पर वापस जाएंगे.

Enums
NULL_VALUE Null वैल्यू.

टूल एनोटेशन

एमसीपी क्लाइंट को टूल एनोटेशन भेजे जाते हैं, ताकि किसी टूल से जुड़े बुनियादी जोखिम के बारे में बताया जा सके. ज़्यादातर क्लाइंट इन संकेतों को भरोसेमंद नहीं मानते. हालांकि, इनका इस्तेमाल यह तय करने के लिए किया जा सकता है कि उपयोगकर्ता को पुष्टि करने का प्रॉम्प्ट कब भेजा जाए.

टाइटल स्ट्रिंग के साथ-साथ, बूलियन हिंट के बारे में यहां बताया गया है:

  • readOnlyHint: अगर इसकी वैल्यू true है, तो टूल अपने एनवायरमेंट में बदलाव नहीं करता. डिफ़ॉल्ट: false.
  • destructiveHint: अगर इसकी वैल्यू true है, तो टूल नुकसान पहुंचाने वाली कार्रवाइयां कर सकता है. अगर यह वैल्यू false पर सेट है, तो टूल सिर्फ़ जोड़ने वाली कार्रवाइयां कर सकता है. डिफ़ॉल्ट: true.
  • idempotentHint: अगर इसकी वैल्यू true है, तो टूल को एक ही आर्ग्युमेंट के साथ बार-बार कॉल करने पर, उसके एनवायरमेंट पर कोई और असर नहीं पड़ेगा. डिफ़ॉल्ट: false.
  • openWorldHint: सही होने पर, टूल बाहरी इकाइयों की 'विशाल दुनिया' के साथ इंटरैक्ट कर सकता है. अगर यह वैल्यू false है, तो टूल सिर्फ़ इंटरनल इकाइयों के साथ इंटरैक्ट कर सकता है. उदाहरण के लिए, वेब सर्च टूल ओपन वर्ल्ड होगा, जबकि मेमोरी टूल ओपन वर्ल्ड नहीं होगा.

Destructive Hint: ❌ | Idempotent Hint: ❌ | Read Only Hint: ❌ | Open World Hint: ✅

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

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

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