MCP Tools Reference: sheetsmcp.googleapis.com

টুল: update_spreadsheet

স্প্রেডশিটে এক বা একাধিক আপডেট প্রয়োগ করে।

REST API-এর spreadsheets.batchUpdate-এর সাথে সঙ্গতিপূর্ণ: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/batchUpdate

সম্ভাব্য আপডেটগুলোর তালিকাটি হলো:

  • updateSpreadsheetProperties : স্প্রেডশীটের বৈশিষ্ট্যগুলো আপডেট করে।
  • updateSheetProperties : একটি শীটের প্রোপার্টিগুলো আপডেট করে।
  • updateDimensionProperties : ডাইমেনশনের প্রোপার্টিগুলো আপডেট করে।
  • updateNamedRange : একটি নামযুক্ত পরিসর আপডেট করে।
  • repeatCell : একটি নির্দিষ্ট পরিসর জুড়ে একটিমাত্র সেলের পুনরাবৃত্তি ঘটায়।
  • addNamedRange : একটি নামযুক্ত রেঞ্জ যোগ করে।
  • deleteNamedRange : একটি নামযুক্ত রেঞ্জ মুছে ফেলে।
  • addSheet : একটি শীট যোগ করে।
  • deleteSheet : একটি শীট মুছে ফেলে।
  • autoFill : বিদ্যমান তথ্যের উপর ভিত্তি করে স্বয়ংক্রিয়ভাবে আরও তথ্য পূরণ করে।
  • cutPaste : এক স্থান থেকে ডেটা কেটে অন্য স্থানে পেস্ট করে।
  • copyPaste : এক স্থান থেকে ডেটা কপি করে অন্য স্থানে পেস্ট করে।
  • mergeCells : সেলগুলোকে একত্রিত করে।
  • unmergeCells : মার্জ করা সেলগুলোকে আনমার্জ করে।
  • updateBorders : একাধিক সেলের বর্ডার আপডেট করে।
  • updateCells : একসাথে অনেকগুলো সেল আপডেট করে।
  • addFilterView : একটি ফিল্টার ভিউ যোগ করে।
  • appendCells : একটি শীটে ডেটাসহ সর্বশেষ সারির পরে সেলগুলো যুক্ত করে।
  • clearBasicFilter : একটি শীটের বেসিক ফিল্টার মুছে ফেলে।
  • deleteDimension : একটি শীটের সারি বা কলাম মুছে ফেলে।
  • deleteEmbeddedObject : একটি শীট থেকে এমবেডেড অবজেক্ট (যেমন, চার্ট, ছবি) মুছে ফেলে।
  • deleteFilterView : একটি শীট থেকে ফিল্টার ভিউ মুছে ফেলে।
  • duplicateFilterView : একটি ফিল্টার ভিউয়ের প্রতিলিপি তৈরি করে।
  • duplicateSheet : একটি শীটের প্রতিলিপি তৈরি করে।
  • findReplace : কোনো নির্দিষ্ট টেক্সট খুঁজে বের করে এবং সেটিকে অন্য টেক্সট দিয়ে প্রতিস্থাপন করে।
  • insertDimension : একটি শীটে নতুন সারি বা কলাম যোগ করে।
  • insertRange : একটি শীটে নতুন সেল যোগ করার জন্য বিদ্যমান সেলগুলোকে স্থানান্তরিত করে।
  • moveDimension : শীটের মধ্যে সারি বা কলামকে অন্য স্থানে সরাতে ব্যবহৃত হয়।
  • updateEmbeddedObjectPosition : একটি এমবেডেড অবজেক্টের (যেমন চার্ট, ছবি) অবস্থান আপডেট করে।
  • pasteData : একটি শীটে ডেটা (HTML বা ডিলিমিটেড) পেস্ট করে।
  • textToColumns : একটি টেক্সট কলামকে একাধিক টেক্সট কলামে রূপান্তর করে।
  • updateFilterView : একটি ফিল্টার ভিউয়ের প্রোপার্টিগুলো আপডেট করে।
  • deleteRange : একটি শীট থেকে একাধিক সেল মুছে ফেলে এবং অবশিষ্ট সেলগুলোকে স্থানান্তরিত করে।
  • appendDimension : একটি শীটের শেষে ডাইমেনশন যুক্ত করে।
  • addConditionalFormatRule : একটি নতুন কন্ডিশনাল ফরম্যাট রুল যোগ করে।
  • updateConditionalFormatRule : বিদ্যমান কোনো কন্ডিশনাল ফরম্যাট রুল আপডেট করে।
  • deleteConditionalFormatRule : বিদ্যমান কোনো কন্ডিশনাল ফরম্যাট রুল মুছে ফেলে।
  • sortRange : একটি নির্দিষ্ট পরিসরের মধ্যে থাকা ডেটা সাজায়।
  • setDataValidation : এক বা একাধিক সেলের জন্য ডেটা ভ্যালিডেশন সেট করে।
  • setBasicFilter : একটি শীটে মৌলিক ফিল্টার সেট করে।
  • addProtectedRange : একটি সুরক্ষিত পরিসর যোগ করে।
  • updateProtectedRange : একটি সুরক্ষিত পরিসর আপডেট করে।
  • deleteProtectedRange : একটি সুরক্ষিত পরিসর মুছে ফেলে।
  • autoResizeDimensions : কোনো ডাইমেনশনের অন্তর্ভুক্ত সেলগুলোর বিষয়বস্তুর উপর ভিত্তি করে এক বা একাধিক ডাইমেনশনকে স্বয়ংক্রিয়ভাবে রিসাইজ করে।
  • addChart : একটি চার্ট যোগ করে।
  • updateChartSpec : একটি চার্টের স্পেসিফিকেশন আপডেট করে।
  • updateBanding : একটি ব্যান্ডেড পরিসর আপডেট করে
  • addBanding : একটি নতুন ব্যান্ডেড রেঞ্জ যোগ করে
  • deleteBanding : একটি ব্যান্ডেড রেঞ্জ মুছে ফেলে
  • createDeveloperMetadata : নতুন ডেভেলপার মেটাডেটা তৈরি করে
  • updateDeveloperMetadata : বিদ্যমান ডেভেলপার মেটাডেটা এন্ট্রি আপডেট করে।
  • deleteDeveloperMetadata : ডেভেলপার মেটাডেটা মুছে ফেলে
  • randomizeRange : একটি রেঞ্জের মধ্যে সারিগুলির ক্রম এলোমেলো করে।
  • addDimensionGroup : নির্দিষ্ট পরিসরের উপর একটি গ্রুপ তৈরি করে।
  • deleteDimensionGroup : নির্দিষ্ট পরিসরের মধ্যে থাকা একটি গ্রুপ মুছে ফেলে।
  • updateDimensionGroup : নির্দিষ্ট গ্রুপের অবস্থা আপডেট করে।
  • trimWhitespace : সেলের অতিরিক্ত স্থান (যেমন স্পেস, ট্যাব বা নতুন লাইন) ছেঁটে ফেলে।
  • deleteDuplicates : একটি সেল রেঞ্জের নির্দিষ্ট কলামগুলিতে থাকা সদৃশ মানযুক্ত সারিগুলি মুছে ফেলে।
  • updateEmbeddedObjectBorder : একটি এমবেডেড অবজেক্টের বর্ডার আপডেট করে।
  • addSlicer : একটি স্লাইসার যোগ করে।
  • updateSlicerSpec : একটি স্লাইসারের স্পেসিফিকেশন আপডেট করে।
  • addDataSource : একটি ডেটা সোর্স যোগ করে।
  • updateDataSource : একটি ডেটা সোর্স আপডেট করে।
  • deleteDataSource : একটি ডেটা সোর্স মুছে ফেলে।
  • refreshDataSource : এক বা একাধিক ডেটা সোর্স এবং সংশ্লিষ্ট ডিবিঅবজেক্ট রিফ্রেশ করে।
  • cancelDataSourceRefresh : এক বা একাধিক ডেটা সোর্স এবং সংশ্লিষ্ট ডিবিঅবজেক্টের রিফ্রেশ বাতিল করে।
  • addTable : একটি টেবিল যোগ করে।
  • updateTable : একটি টেবিল আপডেট করে।
  • deleteTable : একটি টেবিল মুছে ফেলার অনুরোধ।

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

কার্ল অনুরোধ 
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": "update_spreadsheet",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

ইনপুট স্কিমা

বিষয়বস্তু আপডেট করার অনুরোধ

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

string

প্রয়োজনীয়। যে স্প্রেডশিটটি আপডেট করতে হবে তার আইডি।

requests[]

object ( Struct format)

প্রয়োজনীয়। স্প্রেডশিটে প্রয়োগ করার জন্য আপডেটের একটি তালিকা। প্রতিটি অনুরোধ অবশ্যই একটি বৈধ spreadsheets.batchUpdate Request অবজেক্ট হতে হবে, যা https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/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 সেট করা থাকলে পূর্ণসংখ্যার মান নির্বিশেষে একটি Value JSON null হিসেবে নির্গত করে, এবং এর ফলে মানটি আবার 0 তে ফিরে আসে।

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

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

একটি JSON অবজেক্টকে উপস্থাপন করে।

একটি অক্রমবদ্ধ কী-ভ্যালু ম্যাপ, যার উদ্দেশ্য হলো একটি JSON অবজেক্টের অর্থ নিখুঁতভাবে ধারণ করা। এটি যেকোনো যথেচ্ছ JSON পেলোডকে ProtoJSON ফরম্যাটের একটি মেসেজ ফিল্ড হিসেবে পার্স করতে সক্ষম করে।

এটি আন্তঃকার্যকরী 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" } ।

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

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 সেট করা থাকলে পূর্ণসংখ্যার মান নির্বিশেষে একটি Value JSON null হিসেবে নির্গত করে, এবং এর ফলে মানটি আবার 0 তে ফিরে আসে।

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

টুল টীকা

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