MCP Tools Reference: sheetsmcp.googleapis.com

ابزار: get_values

طیف وسیعی از مقادیر را از یک صفحه گسترده برمی‌گرداند. مربوط به spreadsheets.values.get در REST API: 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 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--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
}'

طرحواره ورودی

درخواست دریافت مقادیر

نمایش 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
}
فیلدها
فیلد Union 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 یک نگهبان است که از یک enum با تنها یک مقدار برای نمایش مقدار null برای نوع Value استفاده می‌کند.

فیلدی از نوع NullValue با هر مقداری غیر از 0 نامعتبر در نظر گرفته می‌شود. اکثر سریالایزرهای ProtoJSON صرف نظر از مقدار صحیح، Value با null_value که به عنوان JSON null تنظیم شده است، منتشر می‌کنند و بنابراین به صورت رفت و برگشتی به مقدار 0 می‌رسند.

انوم‌ها
NULL_VALUE مقدار تهی.

حاشیه‌نویسی ابزار

راهنمایی مخرب: ❌ | راهنمایی بی‌اثر: ✅ | راهنمایی فقط خواندنی: ✅ | راهنمایی جهان باز: ✅

دامنه‌های مجوز

به یکی از حوزه‌های OAuth زیر نیاز دارد:

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