MCP Tools Reference: sheetsmcp.googleapis.com

ابزار: insert_dimension

ردیف‌ها یا ستون‌ها را در یک صفحه در یک فهرست خاص درج می‌کند. مربوط به یک درخواست درج ابعاد (InsertDimensionRequest) در spreadsheets.batchUpdate REST API است: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/request

نمونه زیر نحوه استفاده از curl برای فراخوانی ابزار insert_dimension 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": "insert_dimension",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

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

درخواست درج ابعاد

نمایش JSON 
{
  "spreadsheetId": string,
  "sheetId": integer,
  "dimension": enum (Dimension),
  "startIndex": integer,
  "endIndex": integer,
  "inheritFromBefore": boolean
}
فیلدها
spreadsheetId

string

الزامی. شناسه‌ی صفحه‌گسترده برای به‌روزرسانی.

sheetId

integer

الزامی. شناسه‌ی برگه‌ای که قرار است در آن وارد شود.

dimension

enum ( Dimension )

الزامی. ابعادی که باید درج شود.

startIndex

integer

الزامی. اندیس شروع درج (شامل) که از ۰ شروع می‌شود.

endIndex

integer

الزامی. اندیس پایانیِ درج که بر اساس ۰ است (به‌جز).

inheritFromBefore

boolean

اینکه آیا ویژگی‌های ابعاد باید از ابعاد قبل یا بعد از ابعاد جدید درج شده، بسط داده شوند یا خیر. برای ارث‌بری از ابعاد قبل، مقدار True را وارد کنید (که در این صورت اندیس شروع باید بزرگتر از 0 باشد)، و برای ارث‌بری از ابعاد بعد، مقدار false را وارد کنید.

ابعاد

نشان می‌دهد که یک عملیات باید روی کدام بُعد اعمال شود.

انوم‌ها
DIMENSION_UNSPECIFIED مقدار پیش‌فرض، استفاده نکنید.
COLUMNS روی ستون‌های یک برگه عمل می‌کند.
ROWS روی ردیف‌های یک برگه عمل می‌کند.

طرحواره خروجی

نشان دهنده یک شیء JSON است.

یک نگاشت کلید-مقدار نامرتب، با هدف ثبت کامل معانی یک شیء JSON. این امر امکان تجزیه هر بار داده دلخواه JSON را به عنوان یک فیلد پیام در قالب ProtoJSON فراهم می‌کند.

این از دستورالعمل‌های RFC 8259 برای JSON سازگار پیروی می‌کند: به‌ویژه این نوع نمی‌تواند مقادیر بزرگ 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
}
فیلدها
فیلد 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 
{
  "values": [
    value
  ]
}
فیلدها
values[]

value ( Value format)

فیلد تکراری با مقادیر تایپ‌شده‌ی پویا.

مقدار تهی

نشان دهنده یک JSON null .

NullValue یک نگهبان است که از یک enum با تنها یک مقدار برای نمایش مقدار null برای نوع Value استفاده می‌کند.

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

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

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

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