MCP Tools Reference: sheetsmcp.googleapis.com

টুল: get_values

একটি স্প্রেডশিট থেকে মানের একটি পরিসর ফেরত দেয়। এটি REST API-এর spreadsheets.values.get-এর অনুরূপ: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get

নিম্নলিখিত নমুনাটি দেখায় কিভাবে curl ব্যবহার করে ` get_values 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": "get_values",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

ইনপুট স্কিমা

GetValuesRequest

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

string

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

range

string

প্রয়োজনীয়। যে রেঞ্জ থেকে মানগুলো নেওয়া হবে, তার A1 নোটেশন অথবা R1C1 নোটেশন ।

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

স্প্রেডশীটের একটি পরিসরের মধ্যে থাকা ডেটা। https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values

ভ্যালুরেঞ্জ

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

string

মানগুলো যে পরিসরকে অন্তর্ভুক্ত করে, তা A1 নোটেশনে দেখানো হয়েছে।

values[]

array ( ListValue format)

যে ডেটা পড়া হয়েছে। এটি অ্যারের একটি অ্যারে, যার বাইরের অ্যারেটি সমস্ত ডেটা এবং প্রতিটি ভেতরের অ্যারে একটি সারিকে প্রতিনিধিত্ব করে। ভেতরের অ্যারের প্রতিটি আইটেম একটি সেলের সাথে সঙ্গতিপূর্ণ। শেষের খালি সারি এবং কলাম অন্তর্ভুক্ত করা হবে না।

তালিকা মান

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" } ।

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

JSON উপস্থাপনা 
{
  "key": string,
  "value": value
}
ক্ষেত্র
key

string

value

value ( Value format)

নালমান

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

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

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

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

টুল টীকা

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