MCP Tools Reference: sheetsmcp.googleapis.com

টুল: update_values

স্প্রেডশিটের রেঞ্জে ভ্যালু সেট করে।

REST API-তে spreadsheets.values.update-এর সাথে সম্পর্কিত: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update

স্কিমা: - spreadsheet_id (স্ট্রিং, প্রয়োজন): আপডেট করার জন্য স্প্রেডশিটের আইডি। - range (স্ট্রিং, আবশ্যক): আপডেট করার জন্য ভ্যালুর A1 নোটেশন (যেমন, "Sheet1!A1:B2")। - values (অ্যারের অ্যারে, আবশ্যক): সেল ভ্যালুর 2D অ্যারে। যেসব ভ্যালুর ধরন কাজ করে সেগুলি হল: বুলিয়ান, স্ট্রিং এবং সংখ্যা (ফ্লোট/int)।

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

ইনপুট স্কিমা

UpdateValuesRequest

JSON উপস্থাপনা 
{
  "spreadsheetId": string,
  "range": string,
  "values": [
    array
  ]
}
ফিল্ড
spreadsheetId

string

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

string

প্রয়োজনীয়। আপডেট করার জন্য ভ্যালুর A1 নোটেশন।
values[]

array (ListValue format)

প্রয়োজনীয়। যে ডেটা রিড করা হয়েছে বা রাইট করা হবে। এটি হল অ্যারের অ্যারে, বাইরের অ্যারে সব ডেটা দেখায় এবং প্রতিটি ভেতরের অ্যারে একটি সারি দেখায়। ভিতরের অ্যারের প্রতিটি আইটেম একটি সেলের সাথে সম্পর্কিত। যেসব ভ্যালুর ধরন কাজ করে সেগুলি হল: bool, string এবং double। নাল ভ্যালু এড়িয়ে যাওয়া হবে। কোনও সেলের ভ্যালু খালি রাখতে, স্ট্রিং ভ্যালু খালি স্ট্রিং হিসেবে সেট করুন।

ListValue

JSON উপস্থাপনা 
{
  "values": [
    value
  ]
}
ফিল্ড
values[]

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 উপস্থাপনা 
{
  "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)

NullValue

JSON null দেখায়।

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

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

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

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

UpdateValuesResponse

JSON উপস্থাপনা 
{
  "content": {
    object
  }
}
ফিল্ড
content

object (Struct format)

Sheets API-এর JSON ফর্ম্যাটে spreadsheets.values.update উত্তর, সাথে একটি 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