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: স্প্রেডশিটের প্রপার্টি আপডেট করে। স্কিমা:
  • properties (অবজেক্ট, প্রয়োজন): আপডেট করার জন্য স্প্রেডশিট প্রপার্টি ({"title": string, "locale": string, "timeZone": string})।
  • fields (স্ট্রিং, প্রয়োজন): আপডেট করার জন্য প্রপার্টির ফিল্ড মাস্ক (যেমন, "title" বা "*")।
  • updateSheetProperties: শিটের প্রপার্টি আপডেট করে। স্কিমা:
  • properties (অবজেক্ট, প্রয়োজন): শিটের প্রপার্টি ({"sheetId": int, "title": string, "index": int, "gridProperties": {"rowCount": int, "columnCount": int, "frozenRowCount": int, "frozenColumnCount": int, "hideGridlines": bool}, "hidden": bool, "tabColorStyle": {"rgbColor": {"red": float, "green": float, "blue": float}}})।
  • fields (স্ট্রিং, প্রয়োজন): আপডেট করার জন্য প্রপার্টির ফিল্ড মাস্ক (যেমন, "title", "gridProperties.frozenRowCount")।
  • updateDimensionProperties: ডাইমেনশনের প্রপার্টি (যেমন, সারির উচ্চতা বা কলামের প্রস্থ) আপডেট করে। স্কিমা:
  • range (অবজেক্ট, প্রয়োজন): ডাইমেনশন রেঞ্জ ({"sheetId": int, "dimension": "ROWS"|"COLUMNS", "startIndex": int, "endIndex": int})।
  • properties (অবজেক্ট, প্রয়োজন): ডাইমেনশন প্রপার্টি ({"pixelSize": int, "hiddenByUser": bool})।
  • fields (স্ট্রিং, প্রয়োজন): আপডেট করার জন্য প্রপার্টির ফিল্ড মাস্ক (যেমন, "pixelSize")।
  • updateNamedRange: নামযুক্ত ব্যাপ্তি আপডেট করে। স্কিমা:
  • namedRange (অবজেক্ট, প্রয়োজন): নামযুক্ত ব্যাপ্তির সংজ্ঞা ({"namedRangeId": string, "name": string, "range": {"sheetId": int, "startRowIndex": int, "endRowIndex": int, "startColumnIndex": int, "endColumnIndex": int}})।
  • fields (স্ট্রিং, প্রয়োজন): আপডেট করার জন্য ফিল্ডের ফিল্ড মাস্ক (যেমন, "name,range" বা "*")।
  • repeatCell: একটি রেঞ্জ জুড়ে একটি সেল রিপিট করে। স্কিমা:
  • range (অবজেক্ট, প্রয়োজন): সেল ডেটা/ফর্ম্যাটিং প্রয়োগ করার জন্য গ্রিড রেঞ্জ ({"sheetId": int, "startRowIndex": int, "endRowIndex": int, "startColumnIndex": int, "endColumnIndex": int})।
  • cell (অবজেক্ট, প্রয়োজন): সেল ডেটা ({"userEnteredValue": {"stringValue": str, "numberValue": float, "formulaValue": str}, "userEnteredFormat": {"textFormat": {"bold": bool, "italic": bool, "fontSize": int}, "backgroundColorStyle": {"rgbColor": {"red": float, "green": float, "blue": float}}, "horizontalAlignment": "LEFT"|"CENTER"|"RIGHT", "wrapStrategy": "WRAP"|"CLIP"|"OVERFLOW_CELL"}})।
  • fields (স্ট্রিং, প্রয়োজন): আপডেট করার জন্য সেল ফিল্ডের ফিল্ড মাস্ক (যেমন, "userEnteredFormat.textFormat.bold" বা "userEnteredValue")।
  • addNamedRange: নামযুক্ত রেঞ্জ যোগ করে। স্কিমা:
  • namedRange (অবজেক্ট, প্রয়োজন): যোগ করার জন্য নামযুক্ত রেঞ্জ ({"namedRangeId": string (optional), "name": string, "range": {"sheetId": int, "startRowIndex": int, "endRowIndex": int, "startColumnIndex": int, "endColumnIndex": int}})।
  • deleteNamedRange: ID অনুযায়ী নামযুক্ত ব্যাপ্তি মুছে দেয়। স্কিমা:
  • namedRangeId (স্ট্রিং, প্রয়োজন): মুছে ফেলার জন্য নামযুক্ত রেঞ্জের আইডি।
  • addSheet: একটি শিট যোগ করে। স্কিমা:
  • properties (অবজেক্ট, ঐচ্ছিক): শিটের প্রপার্টি ({"title": string, "sheetId": int (optional), "index": int (optional), "gridProperties": {"rowCount": int, "columnCount": int}})।
  • deleteSheet: শিট মুছে দেয়। স্কিমা:
  • sheetId (ইন্টিজার, প্রয়োজন): যে শিট মুছতে হবে তার আইডি।
  • autoFill: আগে থেকে থাকা ডেটার উপর ভিত্তি করে অটোমেটিক আরও ডেটা পূরণ করে। স্কিমা:
  • range (অবজেক্ট, ঐচ্ছিক): পরীক্ষা করে পূরণ করার জন্য রেঞ্জ ({"sheetId": int, "startRowIndex": int, "endRowIndex": int, "startColumnIndex": int, "endColumnIndex": int})।
  • sourceAndDestination (অবজেক্ট, ঐচ্ছিক): স্পষ্ট সোর্স এবং ফিল দৈর্ঘ্য ({"source": GridRange, "dimension": "ROWS"|"COLUMNS", "fillLength": int})।
  • useAlternateSeries (বুলিয়ান, ঐচ্ছিক): বিকল্প সিরিজ ব্যবহার করা হবে কিনা।
  • cutPaste: একটি জায়গা থেকে ডেটা কাট করে অন্য জায়গায় পেস্ট করে। স্কিমা:
  • source (অবজেক্ট, আবশ্যক): সোর্স গ্রিড রেঞ্জ।
  • destination (অবজেক্ট, প্রয়োজন): একদম উপরে বাঁদিকের গন্তব্য কোঅর্ডিনেট ({"sheetId": int, "rowIndex": int, "columnIndex": int})।
  • pasteType (স্ট্রিং, ঐচ্ছিক): "PASTE_NORMAL", "PASTE_VALUES", "PASTE_FORMAT", "PASTE_NO_BORDERS", "PASTE_FORMULA"।
  • copyPaste: একটি জায়গা থেকে ডেটা কপি করে অন্য জায়গায় পেস্ট করে। স্কিমা:
  • source (অবজেক্ট, আবশ্যক): সোর্স গ্রিড রেঞ্জ।
  • destination (অবজেক্ট, আবশ্যক): গন্তব্য গ্রিড রেঞ্জ।
  • pasteType (স্ট্রিং, ঐচ্ছিক): "PASTE_NORMAL", "PASTE_VALUES", "PASTE_FORMAT", "PASTE_NO_BORDERS", "PASTE_FORMULA".
  • pasteOrientation (স্ট্রিং, ঐচ্ছিক): "NORMAL" অথবা "TRANSPOSE"।
  • mergeCells: সেল একসাথে মার্জ করে। স্কিমা:
  • range (অবজেক্ট, আবশ্যক): মার্জ করার জন্য গ্রিড রেঞ্জ।
  • mergeType (স্ট্রিং, প্রয়োজন): "MERGE_ALL", "MERGE_COLUMNS", অথবা "MERGE_ROWS"।
  • unmergeCells: মার্জ করা সেল আনমার্জ করে। স্কিমা:
  • range (অবজেক্ট, আবশ্যক): গ্রিড রেঞ্জ যার মধ্যে সব সেল আনমার্জ করতে হবে।
  • updateBorders: সেলের রেঞ্জে বর্ডার আপডেট করে। স্কিমা:
  • range (অবজেক্ট, প্রয়োজন): যে গ্রিড রেঞ্জের বর্ডার আপডেট করতে হবে।
  • top / bottom / left / right / innerHorizontal / innerVertical (অবজেক্ট, ঐচ্ছিক): বর্ডার স্টাইল ({"style": "SOLID"|"DASHED"|"DOTTED"|"DOUBLE"|"NONE", "width": int, "colorStyle": {"rgbColor": {"red": float, "green": float, "blue": float}}})।
  • updateCells: একসাথে অনেক সেল আপডেট করে। স্কিমা:
  • এলাকা (ঠিক একটি প্রয়োজন):
    • start (অবজেক্ট): উপরে বাঁদিকের কোঅর্ডিনেট ({"sheetId": int, "rowIndex": int, "columnIndex": int})।
    • range (অবজেক্ট): গ্রিড রেঞ্জ।
  • rows (RowData-এর অ্যারে, প্রয়োজন): সেলের সারি ([{"values": [{"userEnteredValue": {"stringValue": str, "numberValue": float, "formulaValue": str}}]}])।
  • fields (স্ট্রিং, প্রয়োজন): আপডেট করার জন্য সেল ফিল্ডের ফিল্ড মাস্ক (যেমন, "userEnteredValue" বা "userEnteredFormat")।
  • addFilterView: ফিল্টার ভিউ যোগ করে। স্কিমা:
  • filter (অবজেক্ট, প্রয়োজন): ফিল্টার ভিউয়ের সংজ্ঞা ({"title": string, "range": GridRange, "criteria": map, "sortSpecs": list})।
  • appendCells: শিটের শেষ সারির পরে সেল যোগ করে যেখানে ডেটা আছে। স্কিমা:
  • sheetId (ইন্টিজার, প্রয়োজন): ডেটা যোগ করার জন্য শিট আইডি।
  • rows (RowData-এর অ্যারে, প্রয়োজন): যোগ করার জন্য ডেটার সারি।
  • fields (স্ট্রিং, প্রয়োজন): ফিল্ড মাস্ক (যেমন, "userEnteredValue")।
  • clearBasicFilter: শিটে প্রাথমিক ফিল্টার মুছে দেয়। স্কিমা:
  • sheetId (ইন্টিজার, প্রয়োজন): শিট আইডি যেখানে বেসিক ফিল্টার মুছতে হবে।
  • deleteDimension: শিটের সারি বা কলাম মুছে দেয়। স্কিমা:
  • range (অবজেক্ট, আবশ্যক): মুছে ফেলার জন্য ডাইমেনশন রেঞ্জ ({"sheetId": int, "dimension": "ROWS"|"COLUMNS", "startIndex": int, "endIndex": int})।
  • deleteEmbeddedObject: শিটে এম্বেড করা অবজেক্ট (যেমন, চার্ট, ছবি) মুছে দেয়। স্কিমা:
  • objectId (পূর্ণসংখ্যা, প্রয়োজন): এম্বেড করা অবজেক্টের আইডি যা মুছে ফেলতে হবে।
  • deleteFilterView: শিট থেকে ফিল্টার ভিউ মুছে দেয়। স্কিমা:
  • filterId (পূর্ণসংখ্যা, আবশ্যক): মুছে ফেলার জন্য ফিল্টার ভিউয়ের আইডি।
  • duplicateFilterView: ফিল্টার ভিউ ডুপ্লিকেট করে। স্কিমা:
  • filterId (পূর্ণসংখ্যা, আবশ্যক): ডুপ্লিকেট করার জন্য ফিল্টার ভিউয়ের আইডি।
  • duplicateSheet: শিট ডুপ্লিকেট করে। স্কিমা:
  • sourceSheetId (ইন্টিজার, প্রয়োজন): ডুপ্লিকেট করার জন্য শিট আইডি।
  • insertSheetIndex (পূর্ণসংখ্যা, ঐচ্ছিক): শূন্য-ভিত্তিক সূচি যেখানে নতুন শিট যোগ করতে হবে।
  • newSheetId (পূর্ণসংখ্যা, ঐচ্ছিক): নতুন শিটের আইডি।
  • newSheetName (স্ট্রিং, ঐচ্ছিক): নতুন শিটের নাম।
  • findReplace: কোনও টেক্সট খুঁজে নিয়ে অন্য টেক্সট দিয়ে তা পরিবর্তন করে। স্কিমা:
  • find (স্ট্রিং, প্রয়োজন): যে ভ্যালু সার্চ করতে হবে।
  • replacement (স্ট্রিং, প্রয়োজন): রিপ্লেসমেন্ট ভ্যালু।
  • স্কোপ (ঠিক একটি প্রয়োজন):
    • range (অবজেক্ট): গ্রিড রেঞ্জ।
    • sheetId (ইন্টিজার): শিট আইডি।
    • allSheets (বুলিয়ান): সব শিট সার্চ করতে true।
  • matchCase / matchEntireCell / searchByRegex / includeFormulas (বুলিয়ান, ঐচ্ছিক)।
  • insertDimension: শিটে নতুন সারি বা কলাম যোগ করে। স্কিমা:
  • range (অবজেক্ট, আবশ্যক): যোগ করার জন্য ডাইমেনশন রেঞ্জ ({"sheetId": int, "dimension": "ROWS"|"COLUMNS", "startIndex": int, "endIndex": int})।
  • inheritFromBefore (বুলিয়ান, ঐচ্ছিক): পূর্ববর্তী সারি/কলাম থেকে ফর্ম্যাটিং ইনহেরিট করতে true।
  • insertRange: আগে থেকে থাকা সেল সরিয়ে শিটে নতুন সেল যোগ করে। স্কিমা:
  • range (অবজেক্ট, প্রয়োজন): সেল যোগ করার জন্য গ্রিড রেঞ্জ।
  • shiftDimension (স্ট্রিং, প্রয়োজন): "ROWS" অথবা "COLUMNS"।
  • moveDimension: শিটের মধ্যে সারি বা কলাম অন্য লোকেশনে সরায়। স্কিমা:
  • source (অবজেক্ট, প্রয়োজন): সোর্স ডাইমেনশন রেঞ্জ ({"sheetId": int, "dimension": "ROWS"|"COLUMNS", "startIndex": int, "endIndex": int})।
  • destinationIndex (পূর্ণসংখ্যা, আবশ্যক): শূন্য-ভিত্তিক গন্তব্য সূচক।
  • updateEmbeddedObjectPosition: এম্বেড করা অবজেক্টের (যেমন, চার্ট, ছবি) পজিশন আপডেট করে। স্কিমা:
  • objectId (ইন্টিজার, প্রয়োজন): এম্বেড করা অবজেক্টের আইডি।
  • newPosition (অবজেক্ট, প্রয়োজন): নতুন পজিশন ({"overlayPosition": {"anchorCell": {"sheetId": int, "rowIndex": int, "columnIndex": int}, "widthPixels": int, "heightPixels": int}})।
  • fields (স্ট্রিং, প্রয়োজন): ফিল্ড মাস্ক (যেমন, "overlayPosition.anchorCell")।
  • pasteData: শিটে ডেটা (HTML বা ডিলিমিটেড) পেস্ট করে। স্কিমা:
  • coordinate (অবজেক্ট, প্রয়োজন): একদম উপরে বাঁদিকের কোঅর্ডিনেট ({"sheetId": int, "rowIndex": int, "columnIndex": int})।
  • data (স্ট্রিং, আবশ্যক): ডিলিমিট করা টেক্সট বা HTML ডেটা।
  • delimiter (স্ট্রিং, ঐচ্ছিক) অথবা html (বুলিয়ান, ঐচ্ছিক)।
  • type (স্ট্রিং, ঐচ্ছিক): "PASTE_NORMAL", "PASTE_VALUES", ইত্যাদি।
  • textToColumns: টেক্সটের একটি কলামকে টেক্সটের একাধিক কলামে কনভার্ট করে। স্কিমা:
  • source (অবজেক্ট, আবশ্যক): সিঙ্গেল-কলাম গ্রিড রেঞ্জ।
  • delimiterType (স্ট্রিং, প্রয়োজন): "COMMA", "SEMICOLON", "PERIOD", "SPACE", "CUSTOM", "AUTODETECT".
  • delimiter (স্ট্রিং, ঐচ্ছিক): delimiterType-এর মান "CUSTOM" হলে ডিলিমিটার অক্ষর।
  • updateFilterView: ফিল্টার ভিউয়ের প্রপার্টি আপডেট করে। স্কিমা:
  • filter (অবজেক্ট, প্রয়োজন): filterViewId সহ ফিল্টার ভিউয়ের সংজ্ঞা।
  • fields (স্ট্রিং, প্রয়োজন): ফিল্ড মাস্ক (যেমন, "title,criteria" বা "*")।
  • deleteRange: শিট থেকে সেলের রেঞ্জ মুছে দেয়, বাকি সেলগুলি সরিয়ে দেয়। স্কিমা:
  • range (অবজেক্ট, আবশ্যক): মুছে ফেলার জন্য গ্রিড রেঞ্জ।
  • shiftDimension (স্ট্রিং, প্রয়োজন): "ROWS" অথবা "COLUMNS"।
  • appendDimension: শিটের শেষে ডাইমেনশন যোগ করে। স্কিমা:
  • sheetId (ইন্টিজার, প্রয়োজন): শিট আইডি।
  • dimension (স্ট্রিং, প্রয়োজন): "ROWS" অথবা "COLUMNS"।
  • length (পূর্ণসংখ্যা, প্রয়োজন): যোগ করার জন্য সারি বা কলামের সংখ্যা।
  • addConditionalFormatRule: শর্তাধীন ফরম্যাটের নতুন নিয়ম যোগ করে। স্কিমা:
  • rule (অবজেক্ট, প্রয়োজন): কন্ডিশনাল ফর্ম্যাটের নিয়ম ({"ranges": [GridRange], "booleanRule": {"condition": {"type": "NUMBER_GREATER_THAN_EQ"|"TEXT_CONTAINS"|..., "values": [{"userEnteredValue": string}]}, "format": CellFormat}, "gradientRule": {...}})।
  • index (পূর্ণসংখ্যা, ঐচ্ছিক): শূন্য-ভিত্তিক সূচক যেখানে নিয়ম সন্নিবেশ করা উচিত।
  • updateConditionalFormatRule: আগে থেকে থাকা কন্ডিশনাল ফর্ম্যাটের নিয়ম আপডেট করে। স্কিমা:
  • rule (অবজেক্ট, আবশ্যক): নতুন শর্তাধীন ফর্ম্যাট নিয়ম।
  • ইন্ডেক্স / নিয়ম আইডি (একটি প্রয়োজন):
    • index (পূর্ণসংখ্যা): নিয়মের শূন্য-ভিত্তিক ইন্ডেক্স।
    • sheetId (ইন্টিজার): শিট ইনডেক্স অনুযায়ী আপডেট করা হলে শিট আইডি।
  • newIndex (পূর্ণসংখ্যা, ঐচ্ছিক): নিয়ম সরানোর জন্য নতুন সূচি।
  • deleteConditionalFormatRule: আগে থেকে থাকা কন্ডিশনাল ফর্ম্যাট নিয়ম মুছে দেয়। স্কিমা:
  • index (পূর্ণসংখ্যা, আবশ্যক): মুছে ফেলার জন্য নিয়মের জিরো-বেসড ইন্ডেক্স।
  • sheetId (ইন্টিজার, আবশ্যক): নিয়মের শিট আইডি।
  • sortRange: রেঞ্জের মধ্যে ডেটা সাজায়। স্কিমা:
  • range (অবজেক্ট, আবশ্যক): সাজানোর জন্য গ্রিড রেঞ্জ।
  • sortSpecs (SortSpec-এর অ্যারে, প্রয়োজন): স্পেসিফিকেশন সাজান ([{"dimensionIndex": int, "sortOrder": "ASCENDING"|"DESCENDING"}])।
  • setDataValidation: এক বা একাধিক সেলের জন্য ডেটা যাচাইকরণ সেট করে। স্কিমা:
  • range (অবজেক্ট, আবশ্যক): গ্রিড রেঞ্জ।
  • rule (অবজেক্ট, ঐচ্ছিক): যাচাইকরণের নিয়ম ({"condition": {"type": "ONE_OF_LIST"|"NUMBER_BETWEEN"|..., "values": [{"userEnteredValue": string}]}, "strict": bool, "showCustomUi": bool})। বাদ দেওয়া হলে, যাচাইকরণ মুছে দেয়।
  • setBasicFilter: শিটে প্রাথমিক ফিল্টার সেট করে। স্কিমা:
  • filter (অবজেক্ট, প্রয়োজন): বেসিক ফিল্টার সংজ্ঞা ({"range": GridRange, "criteria": map, "sortSpecs": list})।
  • addProtectedRange: একটি সুরক্ষিত রেঞ্জ যোগ করে। স্কিমা:
  • protectedRange (অবজেক্ট, প্রয়োজন): সুরক্ষিত রেঞ্জের সংজ্ঞা ({"range": GridRange, "description": string, "warningOnly": bool, "editors": {"users": [string]}})।
  • updateProtectedRange: সুরক্ষিত রেঞ্জ আপডেট করে। স্কিমা:
  • protectedRange (অবজেক্ট, আবশ্যক): protectedRangeId সহ সুরক্ষিত রেঞ্জের সংজ্ঞা।
  • fields (স্ট্রিং, প্রয়োজন): ফিল্ড মাস্ক (যেমন, "description,warningOnly" বা "*")।
  • deleteProtectedRange: সুরক্ষিত রেঞ্জ মুছে দেয়। স্কিমা:
  • protectedRangeId (ইন্টিজার, আবশ্যক): সুরক্ষিত রেঞ্জের আইডি যা মুছে ফেলতে হবে।
  • autoResizeDimensions: সেলের কন্টেন্টের উপর ভিত্তি করে এক বা একাধিক ডাইমেনশন অটোমেটিক ছোট বড় করে। স্কিমা:
  • dimensions (অবজেক্ট, প্রয়োজন): ডাইমেনশন রেঞ্জ ({"sheetId": int, "dimension": "ROWS"|"COLUMNS", "startIndex": int, "endIndex": int})।
  • addChart: চার্ট যোগ করে। স্কিমা:
  • chart (অবজেক্ট, আবশ্যক): চার্টের সংজ্ঞা ({"spec": {"title": string, "basicChart": {"chartType": "COLUMN"|"BAR"|"LINE"|"PIE"|"COMBO"|"SCATTER", "legendPosition": string, "axis": list, "domains": list, "series": list}}, "position": {"overlayPosition": {"anchorCell": {"sheetId": int, "rowIndex": int, "columnIndex": int}}}})।
  • updateChartSpec: চার্টের স্পেসিফিকেশন আপডেট করে। স্কিমা:
  • chartId (ইন্টিজার, প্রয়োজন): চার্টের আইডি।
  • spec (অবজেক্ট, আবশ্যক): নতুন চার্ট স্পেসিফিকেশন।
  • updateBanding: ব্যান্ডেড রেঞ্জ আপডেট করে। স্কিমা:
  • bandedRange (অবজেক্ট, আবশ্যক): bandedRangeId সহ ব্যান্ডেড রেঞ্জের সংজ্ঞা।
  • fields (স্ট্রিং, প্রয়োজন): ফিল্ড মাস্ক।
  • addBanding: নতুন ব্যান্ডেড রেঞ্জ যোগ করে। স্কিমা:
  • bandedRange (অবজেক্ট, আবশ্যক): ব্যান্ডেড রেঞ্জের সংজ্ঞা ({"range": GridRange, "rowProperties": {"headerColorStyle": ColorStyle, "firstBandColorStyle": ColorStyle, "secondBandColorStyle": ColorStyle}})।
  • deleteBanding: ব্যান্ডেড রেঞ্জ সরিয়ে দেয়। স্কিমা:
  • bandedRangeId (পূর্ণসংখ্যা, প্রয়োজন): মুছে ফেলার জন্য ব্যান্ডেড রেঞ্জের আইডি।
  • createDeveloperMetadata: নতুন ডেভেলপার মেটাডেটা তৈরি করে। স্কিমা:
  • developerMetadata (অবজেক্ট, প্রয়োজন): মেটাডেটার সংজ্ঞা ({"metadataKey": string, "metadataValue": string, "location": {"locationType": "ROW"|"COLUMN"|"SHEET"|"SPREADSHEET", "sheetId": int}, "visibility": "DOCUMENT"|"PROJECT"})।
  • updateDeveloperMetadata: আগে থেকে থাকা ডেভেলপার মেটাডেটা এন্ট্রি আপডেট করে। স্কিমা:
  • dataFilters (DataFilter-এর অ্যারে, প্রয়োজন): মেটাডেটা বেছে নেওয়ার জন্য ফিল্টার।
  • developerMetadata (অবজেক্ট, প্রয়োজন): আপডেট করা মেটাডেটা ভ্যালু।
  • fields (স্ট্রিং, প্রয়োজন): ফিল্ড মাস্ক।
  • deleteDeveloperMetadata: ডেভেলপার মেটাডেটা মুছে দেয়। স্কিমা:
  • dataFilter (অবজেক্ট, প্রয়োজন): মেটাডেটা মুছে ফেলার জন্য ফিল্টার বর্ণনা করার মাপকাঠি।
  • randomizeRange: কোনও রেঞ্জের মধ্যে সারির ক্রম র‍্যান্ডমাইজ করে। স্কিমা:
  • range (অবজেক্ট, আবশ্যক): র‍্যান্ডমাইজ করার জন্য গ্রিড রেঞ্জ।
  • addDimensionGroup: নির্দিষ্ট রেঞ্জের উপর একটি গ্রুপ তৈরি করে। স্কিমা:
  • range (অবজেক্ট, প্রয়োজন): গ্রুপ করার জন্য ডাইমেনশন রেঞ্জ ({"sheetId": int, "dimension": "ROWS"|"COLUMNS", "startIndex": int, "endIndex": int})।
  • deleteDimensionGroup: নির্দিষ্ট রেঞ্জের মধ্যে থাকা গ্রুপ মুছে দেয়। স্কিমা:
  • range (অবজেক্ট, প্রয়োজন): মুছে ফেলার জন্য গ্রুপের ডাইমেনশন রেঞ্জ।
  • updateDimensionGroup: নির্দিষ্ট গ্রুপের স্ট্যাটাস আপডেট করে। স্কিমা:
  • dimensionGroup (অবজেক্ট, প্রয়োজন): গ্রুপের সংজ্ঞা ({"range": DimensionRange, "depth": int, "collapsed": bool})।
  • fields (স্ট্রিং, প্রয়োজন): ফিল্ড মাস্ক (যেমন, "collapsed")।
  • trimWhitespace: হোয়াইটস্পেসের (যেমন স্পেস, ট্যাব বা নতুন লাইন) সেল ট্রিম করে। স্কিমা:
  • range (অবজেক্ট, আবশ্যক): গ্রিড রেঞ্জ যার সেল ট্রিম করতে হবে।
  • deleteDuplicates: সেল রেঞ্জের নির্দিষ্ট কলামে ডুপ্লিকেট ভ্যালু আছে এমন সারি সরিয়ে দেয়। স্কিমা:
  • range (অবজেক্ট, প্রয়োজন): যে গ্রিড রেঞ্জ থেকে ডুপ্লিকেট সরাতে হবে।
  • comparisonColumns (DimensionRange-এর অ্যারে, ঐচ্ছিক): বিশ্লেষণ করার জন্য নির্দিষ্ট কলাম।
  • updateEmbeddedObjectBorder: এম্বেড করা অবজেক্টের বর্ডার আপডেট করে। স্কিমা:
  • objectId (পূর্ণসংখ্যা, প্রয়োজন): এম্বেড করা অবজেক্টের আইডি।
  • border (অবজেক্ট, প্রয়োজন): বর্ডার সংজ্ঞা ({"colorStyle": ColorStyle, "section": "ALL"})।
  • fields (স্ট্রিং, প্রয়োজন): ফিল্ড মাস্ক।
  • addSlicer: স্লাইসার যোগ করে। স্কিমা:
  • slicer (অবজেক্ট, আবশ্যক): স্লাইসার সংজ্ঞা ({"spec": {"dataRange": GridRange, "columnIndex": int, "title": string}, "position": {"overlayPosition": {"anchorCell": {"sheetId": int, "rowIndex": int, "columnIndex": int}}}})।
  • updateSlicerSpec: স্লাইসারের স্পেসিফিকেশন আপডেট করে। স্কিমা:
  • slicerId (পূর্ণসংখ্যা, প্রয়োজন): স্লাইসারের আইডি।
  • spec (অবজেক্ট, আবশ্যক): নতুন স্লাইসার স্পেসিফিকেশন।
  • fields (স্ট্রিং, প্রয়োজন): ফিল্ড মাস্ক।
  • addDataSource: ডেটা সোর্স যোগ করে। স্কিমা:
  • dataSource (অবজেক্ট, প্রয়োজন): ডেটা সোর্সের সংজ্ঞা ({"spec": {"bigQuery": {"projectId": string, "query": string}}})।
  • updateDataSource: ডেটা সোর্স আপডেট করে। স্কিমা:
  • dataSource (অবজেক্ট, প্রয়োজন): dataSourceId সহ ডেটা সোর্সের সংজ্ঞা।
  • fields (স্ট্রিং, প্রয়োজন): ফিল্ড মাস্ক।
  • deleteDataSource: ডেটা সোর্স মুছে দেয়। স্কিমা:
  • dataSourceId (স্ট্রিং, প্রয়োজন): মুছে ফেলার জন্য ডেটা সোর্সের আইডি।
  • refreshDataSource: এক বা একাধিক ডেটা সোর্স এবং সংশ্লিষ্ট dbobjects রিফ্রেশ করে। স্কিমা:
  • dataSourceId (স্ট্রিং, ঐচ্ছিক) অথবা isAll (বুলিয়ান, ঐচ্ছিক) অথবা references (অবজেক্ট, ঐচ্ছিক)।
  • force (বুলিয়ান, ঐচ্ছিক): রিফ্রেশ করতে বাধ্য করা হবে কিনা।
  • cancelDataSourceRefresh: এক বা একাধিক ডেটা সোর্স এবং সংশ্লিষ্ট dbobjects রিফ্রেশ করা বাতিল করে। স্কিমা:
  • dataSourceId (স্ট্রিং, ঐচ্ছিক) অথবা isAll (বুলিয়ান, ঐচ্ছিক) অথবা references (অবজেক্ট, ঐচ্ছিক)।
  • addTable: টেবিল যোগ করে। স্কিমা:
  • table (অবজেক্ট, প্রয়োজন): টেবিলের সংজ্ঞা ({"range": GridRange, "name": string, "hasHeaderRow": bool, "hasTotalsRow": bool})।
  • updateTable: টেবিল আপডেট করে। স্কিমা:
  • table (অবজেক্ট, প্রয়োজন): tableId সহ টেবিলের সংজ্ঞা।
  • fields (স্ট্রিং, প্রয়োজন): ফিল্ড মাস্ক।
  • deleteTable: টেবিল মুছে ফেলার অনুরোধ। স্কিমা:
  • tableId (স্ট্রিং, প্রয়োজন): মুছে ফেলার জন্য টেবিলের আইডি।
  • insertComment: স্প্রেডশিটে একটি কমেন্ট যোগ করে। স্কিমা:
  • content (স্ট্রিং, প্রয়োজন): প্লেন টেক্সট কমেন্ট কন্টেন্ট।
  • coordinate (অবজেক্ট, প্রয়োজন): কমেন্ট অ্যাঙ্কর করার জন্য শিটে গ্রিড কোঅর্ডিনেট:
    • sheetId (ইন্টিজার, প্রয়োজন): শিট আইডি।
    • rowIndex (পূর্ণসংখ্যা, আবশ্যক): শূন্য-ভিত্তিক সারি সূচক।
    • columnIndex (পূর্ণসংখ্যা, আবশ্যক): শূন্য থেকে শুরু হওয়া কলাম ইন্ডেক্স।
  • assigneeEmailAddress (স্ট্রিং, ঐচ্ছিক): কমেন্ট অ্যাসাইন করা ব্যক্তির ইমেল আইডি।
  • addCommentReply: আগে থেকে থাকা কমেন্ট থ্রেডে উত্তর যোগ করে। এছাড়াও, কোনও থ্রেড সমাধান বা আবার খোলার জন্য ব্যবহার করা হয়। স্কিমা:
  • commentId (স্ট্রিং, প্রয়োজন): কমেন্ট থ্রেডের আইডি।
  • post (অবজেক্ট, প্রয়োজন):
    • content (স্ট্রিং, commentAction-এর মান RESOLVE বা REOPEN না হলে, এটি আবশ্যক): উত্তর পোস্টের প্লেন টেক্সট কন্টেন্ট।
    • commentAction (স্ট্রিং, ঐচ্ছিক): এই উত্তরের সাথে নেওয়া অ্যাকশন ("RESOLVE" বা "REOPEN")।
    • assigneeEmail (স্ট্রিং, ঐচ্ছিক): থ্রেডটি নতুন করে অ্যাসাইন করার জন্য ইমেল আইডি।
  • updateCommentPost: কমেন্ট থ্রেডে কমেন্ট পোস্টের কন্টেন্ট আপডেট করে। স্কিমা:
  • commentId (স্ট্রিং, প্রয়োজন): কমেন্ট থ্রেডের আইডি।
  • postId (স্ট্রিং, প্রয়োজন): আপডেট করার জন্য কমেন্ট পোস্টের আইডি।
  • content (স্ট্রিং, প্রয়োজন): কমেন্ট পোস্টের আপডেট করা কন্টেন্ট।
  • deleteComment: কমেন্ট থ্রেড মুছে দেয়। স্কিমা:
  • commentId (স্ট্রিং, প্রয়োজন): কমেন্ট থ্রেড মুছে দেওয়ার আইডি।
  • deleteCommentReply: উত্তরের পোস্ট মুছে দেয়। স্কিমা:
  • commentId (স্ট্রিং, প্রয়োজন): কমেন্ট থ্রেডের আইডি।
  • postId (স্ট্রিং, প্রয়োজন): মুছে ফেলার জন্য উত্তর পোস্টের আইডি।

update_spreadsheet MCP টুল কল করার জন্য কীভাবে curl ব্যবহার করতে হয় তা নিম্নলিখিত কোড স্যাম্পেল থেকে জানতে পারবেন।

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": "update_spreadsheet",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

ইনপুট স্কিমা

UpdateContentRequest

JSON উপস্থাপনা 
{
  "spreadsheetId": string,
  "requests": [
    {
      object
    }
  ],
  "writeControl": {
    object (WriteControl)
  }
}
ফিল্ড
spreadsheetId

string

প্রয়োজনীয়। আপডেট করার জন্য স্প্রেডশিটের আইডি।
requests[]

object (Struct format)

প্রয়োজনীয়। স্প্রেডশিটে প্রয়োগ করার জন্য আপডেটের তালিকা। প্রতিটি অনুরোধ একটি সঠিক spreadsheets.batchUpdate অনুরোধ অবজেক্ট হতে হবে, যা এই স্কিমা ডকুমেন্ট ব্যবহার করে: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/request অনুরোধগুলি যেভাবে নির্দিষ্ট করা হয়েছে সেই ক্রমে প্রয়োগ করা হবে। কোনও অনুরোধ সঠিক না হলে, কোনও অনুরোধই প্রয়োগ করা হবে না।
writeControl

object (WriteControl)

ঐচ্ছিক। লেখার অনুরোধ কীভাবে কার্যকর করা হবে তা নিয়ন্ত্রণ করার সুবিধা প্রদান করে।

স্ট্রাক্ট

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)

ডায়নামিকালি টাইপ করা ভ্যালুর রিপিট করা ফিল্ড।

WriteControl

JSON উপস্থাপনা 
{

  "requiredRevisionId": string
}
ফিল্ড
control ফিল্ড একত্রিত করুন। স্প্রেডশিটের কোন রিভিশনে লিখতে হবে এবং সেই রিভিশনটি স্প্রেডশিটের বর্তমান রিভিশন না হলে অনুরোধটি কীভাবে আচরণ করবে তা নির্ধারণ করে। control শুধুমাত্র নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
requiredRevisionId

string

স্প্রেডশিটের রিভিশন আইডি যাতে লেখার অনুরোধ প্রয়োগ করা হবে। এটি যদি ডকুমেন্টের লেটেস্ট রিভিশন না হয়, তাহলে অনুরোধ প্রসেস করা হবে না এবং 400 ব্যাড রিকোয়েস্ট সংক্রান্ত সমস্যা দেখাবে।

প্রয়োজনীয় রিভিশন আইডি উত্তরে ফেরত দেওয়া হলে, এটি অনুরোধ প্রয়োগ করার পরে স্প্রেডশিটের রিভিশন আইডি নির্দেশ করে।

NullValue

JSON null দেখায়।

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

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

Enums
NULL_VALUE নাল ভ্যালু।

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

UpdateContentResponse

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 হল একটি সেন্টিনেল, Value টাইপ ইউনিয়নের জন্য নাল ভ্যালু দেখানোর জন্য শুধুমাত্র একটি ভ্যালু সহ enum ব্যবহার করা হচ্ছে।

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

Enums
NULL_VALUE নাল ভ্যালু।

টুল অ্যানোটেশন

প্রদত্ত টুলের প্রাথমিক ঝুঁকি বর্ণনা করার জন্য MCP ক্লায়েন্টদের টুল অ্যানোটেশন পাঠানো হয়। বেশিরভাগ ক্লায়েন্ট এইসব ইঙ্গিতকে বিশ্বাসযোগ্য বলে মনে করে না, তবে ব্যবহারকারীকে কখন কনফার্মেশন প্রম্পট পাঠানো হবে তা নির্ধারণ করতে এগুলি ব্যবহার করা যেতে পারে।

টাইটেল স্ট্রিংয়ের সাথে, নিম্নলিখিত বুলিয়ান হিন্ট এইভাবে সংজ্ঞায়িত করা হয়:

  • readOnlyHint: সত্য হলে, টুলটি তার পরিবেশ পরিবর্তন করে না। ডিফল্ট: false.
  • destructiveHint: সত্য হলে, টুলটি ধ্বংসাত্মক অ্যাকশন করতে পারে। মিথ্যা হলে, টুলটি শুধুমাত্র যোগ করার অ্যাকশন করতে পারে। ডিফল্ট: true.
  • idempotentHint: সত্য হলে, একই আর্গুমেন্ট সহ টুলটিকে বারবার কল করলে এর এনভায়রনমেন্টে কোনও অতিরিক্ত প্রভাব পড়বে না। ডিফল্ট: false.
  • openWorldHint: সত্য হলে, টুলটি এক্সটার্নাল এন্টিটির 'মুক্ত পৃথিবী'-র সাথে ইন্টার‍্যাক্ট করতে পারে। মিথ্যা হলে, টুলটি শুধুমাত্র অভ্যন্তরীণ এন্টিটির সাথে ইন্টার‍্যাক্ট করতে পারে। যেমন, ওয়েব সার্চ টুল ওপেন ওয়ার্ল্ড হলেও মেমরি টুল ওপেন ওয়ার্ল্ড নয়।

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

অনুমোদনের স্কোপ

নিম্নলিখিত OAuth স্কোপগুলির মধ্যে একটি প্রয়োজন:

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