MCP Tools Reference: docsmcp.googleapis.com

टूल: update_doc

यह फ़ंक्शन, बैच अपडेट के अनुरोधों का इस्तेमाल करके किसी दस्तावेज़ को अपडेट करता है. यह documents.batchUpdate अनुरोध (JSON के तौर पर) स्वीकार करता है.

यह REST API में documents.batchUpdate से मेल खाता है.

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

  • replaceAllText: इससे, तय किए गए टेक्स्ट के सभी इंस्टेंस बदल जाते हैं.
  • insertText: इससे चुनी गई जगह पर टेक्स्ट डाला जाता है.
  • updateTextStyle: इससे चुनी गई रेंज में टेक्स्ट की स्टाइल अपडेट की जाती है.
  • createParagraphBullets: पैराग्राफ़ के लिए बुलेट बनाता है.
  • deleteParagraphBullets: पैराग्राफ़ से बुलेट हटाता है.
  • createNamedRange: इससे नाम वाली रेंज बनाई जाती है.
  • deleteNamedRange: नाम वाली रेंज मिटाता है.
  • updateParagraphStyle: यह फ़ंक्शन, तय की गई रेंज में पैराग्राफ़ स्टाइल को अपडेट करता है.
  • deleteContentRange: दस्तावेज़ से कॉन्टेंट मिटाता है.
  • insertInlineImage: इससे तय की गई जगह पर, इनलाइन इमेज डाली जाती है.
  • insertTable: इससे बताई गई जगह पर टेबल शामिल की जाती है.
  • insertTableRow: इससे टेबल में एक खाली लाइन जुड़ जाती है.
  • insertTableColumn: इससे टेबल में एक खाली कॉलम जुड़ जाता है.
  • deleteTableRow: किसी टेबल से कोई लाइन मिटाता है.
  • deleteTableColumn: इससे टेबल से कोई कॉलम मिटाया जाता है.
  • insertPageBreak: इससे चुनी गई जगह पर पेज ब्रेक डाला जाता है.
  • deletePositionedObject: इस फ़ंक्शन का इस्तेमाल करके, दस्तावेज़ में मौजूद किसी ऑब्जेक्ट को मिटाया जा सकता है.
  • updateTableColumnProperties: इस फ़ंक्शन का इस्तेमाल करके, किसी टेबल में मौजूद कॉलम की प्रॉपर्टी अपडेट की जाती हैं.
  • updateTableCellStyle: इससे टेबल सेल के स्टाइल को अपडेट किया जाता है.
  • updateTableRowStyle: यह फ़ंक्शन, टेबल में लाइन की स्टाइल को अपडेट करता है.
  • replaceImage: दस्तावेज़ में मौजूद किसी इमेज को बदलता है.
  • updateDocumentStyle: दस्तावेज़ की स्टाइल अपडेट करता है.
  • insertInlineSheetsChart: इससे Google Sheets का कोई चार्ट, दस्तावेज़ में तय की गई जगह पर डाला जाता है.
  • mergeTableCells: इसका इस्तेमाल टेबल में मौजूद सेल को मर्ज करने के लिए किया जाता है.
  • unmergeTableCells: टेबल में सेल अनमर्ज करता है.
  • refreshSheetsChart: Google Sheets के चार्ट को रीफ़्रेश करता है.
  • createHeader: इससे हेडर बनाया जाता है.
  • createFooter: फ़ुटर बनाता है.
  • createFootnote: इससे फ़ुटनोट बनता है.
  • replaceNamedRangeContent: इससे नाम वाली रेंज में मौजूद कॉन्टेंट बदल जाता है.
  • updateEmbeddedObject: इससे एम्बेड किए गए ऑब्जेक्ट की प्रॉपर्टी अपडेट होती हैं.
  • updateSectionStyle: इससे चुनी गई रेंज के सेक्शन स्टाइल को अपडेट किया जाता है.
  • insertSectionBreak: इससे चुनी गई जगह पर सेक्शन ब्रेक डाला जाता है.
  • deleteHeader: इससे दस्तावेज़ से हेडर मिट जाता है.
  • deleteFooter: इससे दस्तावेज़ से फ़ुटर मिट जाता है.
  • pinTableHeaderRows: यह फ़ंक्शन, किसी टेबल में पिन की गई हेडर लाइनों की संख्या को अपडेट करता है.
  • addDocumentTab: इससे दस्तावेज़ टैब जुड़ जाता है.
  • deleteTab: दस्तावेज़ का टैब मिटाता है.
  • updateDocumentTabProperties: यह कुकी, दस्तावेज़ टैब की प्रॉपर्टी अपडेट करती है.
  • insertPerson: इससे किसी व्यक्ति का नाम डाला जाता है.
  • updateNamedStyle: इससे किसी स्टाइल का नाम अपडेट किया जाता है.
  • insertRichLink: रिच लिंक डालें.
  • insertDate: इससे तारीख डाली जाती है.
  • insertComment: दस्तावेज़ में CommentThread डालता है.
  • addCommentReply: इस तरीके का इस्तेमाल करके, किसी CommentThread या SuggestionThread में जवाब जोड़ा जाता है.
  • updateCommentPost: CommentThread या SuggestionThread की किसी मौजूदा पोस्ट (मुख्य पोस्ट या जवाब) को अपडेट करता है.
  • deleteComment: इस तरीके का इस्तेमाल करके, CommentThread को मिटाया जा सकता है.
  • deleteCommentReply: यह CommentThread या SuggestionThread से किसी जवाब वाली पोस्ट को मिटाता है.
  • acceptSuggestion: किसी सुझाव को स्वीकार करता है.
  • rejectSuggestion: किसी सुझाव को अस्वीकार करता है.
  • deleteSuggestion: इससे सुझाव मिटाया जाता है.

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

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

इनपुट स्कीमा

UpdateDocRequest

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

string

ज़रूरी है. अपडेट किए जाने वाले दस्तावेज़ का आईडी. यह Drive टूल के file_id के जैसा ही है.
requests[]

object (Struct format)

दस्तावेज़ में लागू किए जाने वाले अपडेट की सूची. हर अनुरोध, एक मान्य documents.batchUpdate Request ऑब्जेक्ट होना चाहिए. इसके लिए, इस दस्तावेज़ में दिए गए स्कीमा का इस्तेमाल करें: https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/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 शून्य वैल्यू.

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

UpdateDocResponse

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

object (Struct format)

बैच अपडेट के अनुरोधों को पूरा करने के जवाब. इसमें गड़बड़ियां, चेतावनियां, और एपीआई से मिले रॉ डेटा शामिल होता है, ताकि मॉडल में बदलाव किए जा सकें. एपीआई से मिले रॉ रिस्पॉन्स में, इस दस्तावेज़ में दिया गया स्कीमा इस्तेमाल किया जाता है: https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/response

स्ट्रक्ट

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

टूल एनोटेशन

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