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 : নির্দিষ্ট স্থানে একটি পৃষ্ঠা বিরতি (page break) যোগ করে।
  • deletePositionedObject : ডকুমেন্ট থেকে একটি পজিশনড অবজেক্ট মুছে ফেলে।
  • updateTableColumnProperties : একটি টেবিলের কলামগুলোর প্রোপার্টি আপডেট করে।
  • updateTableCellStyle : টেবিলের সেলগুলোর স্টাইল আপডেট করে।
  • updateTableRowStyle : টেবিলের সারির স্টাইল আপডেট করে।
  • replaceImage : ডকুমেন্টের কোনো ছবি প্রতিস্থাপন করে।
  • updateDocumentStyle : ডকুমেন্টের স্টাইল আপডেট করে।
  • insertInlineSheetsChart : নির্দিষ্ট স্থানে একটি ইনলাইন গুগল শিটস চার্ট যুক্ত করে।
  • mergeTableCells : টেবিলের সেলগুলোকে একত্রিত করে।
  • unmergeTableCells : টেবিলের সেলগুলোকে আলাদা করে।
  • refreshSheetsChart : গুগল শিটস চার্ট রিফ্রেশ করে।
  • 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 : একটি মন্তব্য থ্রেড মুছে দেয়।
  • deleteCommentReply : কোনো CommentThread বা SuggestionThread থেকে একটি রিপ্লাই পোস্ট মুছে দেয়।
  • acceptSuggestion : কোনো পরামর্শ গ্রহণ করে।
  • rejectSuggestion : কোনো পরামর্শ প্রত্যাখ্যান করে।
  • deleteSuggestion : একটি সাজেশন মুছে ফেলে।

নিম্নলিখিত নমুনাটি দেখায় কিভাবে curl ব্যবহার করে ` update_doc MCP টুলটি চালু করা যায়।

কার্ল অনুরোধ 
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

আবশ্যক। যে ডকুমেন্টটি আপডেট করতে হবে তার আইডি। এটি ড্রাইভ টুলসের 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" } ।

ফিল্ড এন্ট্রি

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 অ্যারে উপস্থাপন করে।

তালিকা মান

JSON উপস্থাপনা 
{
  "values": [
    value
  ]
}
ক্ষেত্র
values[]

value ( Value format)

গতিশীলভাবে টাইপ করা মানগুলির পুনরাবৃত্ত ক্ষেত্র।

নালমান

একটি JSON null উপস্থাপন করে।

NullValue হলো একটি সেন্টিনেল, যা Value টাইপ ইউনিয়নের নাল ভ্যালু বোঝাতে শুধুমাত্র একটি ভ্যালুযুক্ত একটি এনাম ব্যবহার করে।

NullValue টাইপের কোনো ফিল্ডে 0 ছাড়া অন্য কোনো মান থাকলে তা অবৈধ বলে বিবেচিত হয়। বেশিরভাগ ProtoJSON সিরিয়ালাইজার, null_value কে পূর্ণসংখ্যার মান নির্বিশেষে, একটি JSON null হিসাবে সেট করা Value নির্গত করে এবং এর ফলে মানটি 0 তে ফিরে আসে।

এনাম
NULL_VALUE নাল মান।

আউটপুট স্কিমা

UpdateDocResponse

JSON উপস্থাপনা 
{
  "replies": [
    {
      object
    }
  ]
}
ক্ষেত্র
replies[]

object ( Struct format)

ব্যাচ আপডেট অনুরোধগুলি কার্যকর করার ফলে প্রাপ্ত উত্তরগুলি। এর মধ্যে ত্রুটি, সতর্কতা এবং মডেলকে প্রয়োজনীয় সমন্বয় করতে সাহায্য করার জন্য সরাসরি এপিআই (API) প্রতিক্রিয়া অন্তর্ভুক্ত রয়েছে। সরাসরি এপিআই (API) প্রতিক্রিয়াগুলি 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" } ।

ফিল্ড এন্ট্রি

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 অ্যারে উপস্থাপন করে।

তালিকা মান

JSON উপস্থাপনা 
{
  "values": [
    value
  ]
}
ক্ষেত্র
values[]

value ( Value format)

গতিশীলভাবে টাইপ করা মানগুলির পুনরাবৃত্ত ক্ষেত্র।

নালমান

একটি JSON null উপস্থাপন করে।

NullValue হলো একটি সেন্টিনেল, যা Value টাইপ ইউনিয়নের নাল ভ্যালু বোঝাতে শুধুমাত্র একটি ভ্যালুযুক্ত একটি এনাম ব্যবহার করে।

NullValue টাইপের কোনো ফিল্ডে 0 ছাড়া অন্য কোনো মান থাকলে তা অবৈধ বলে বিবেচিত হয়। বেশিরভাগ ProtoJSON সিরিয়ালাইজার, null_value কে পূর্ণসংখ্যার মান নির্বিশেষে, একটি JSON null হিসাবে সেট করা Value নির্গত করে এবং এর ফলে মানটি 0 তে ফিরে আসে।

এনাম
NULL_VALUE নাল মান।

টুল টীকা

ধ্বংসাত্মক ইঙ্গিত: ❌ | স্বকীয় ইঙ্গিত: ❌ | শুধুমাত্র পঠনযোগ্য ইঙ্গিত: ❌ | উন্মুক্ত বিশ্ব ইঙ্গিত: ✅