MCP Tools Reference: sheetsmcp.googleapis.com

כלי: insert_dimension

הוספת שורות או עמודות בגיליון באינדקס מסוים.

תואם ל-InsertDimensionRequest ב-API בארכיטקטורת REST של spreadsheets.batchUpdate: ‏https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/request

סכימה: - spreadsheet_id (מחרוזת, חובה): המזהה של הגיליון האלקטרוני שצריך לעדכן. ‫- sheet_id (מספר שלם, חובה): המזהה של הגיליון שאליו רוצים להוסיף את הנתונים. ‫- dimension (מחרוזת, חובה): "ROWS" או "COLUMNS". ‫- start_index (מספר שלם, חובה): אינדקס ההתחלה של ההוספה (כולל), שמבוסס על 0. ‫- end_index (מספר שלם, חובה): אינדקס הסיום של ההוספה, כשהספירה מתחילה מ-0 (לא כולל). ‫- inherit_from_before (ערך בוליאני, אופציונלי): אם מאפייני המימדים צריכים להתרחב מהמימדים שלפני (true) או אחרי (false).

בדוגמת הקוד הבאה מוסבר איך להשתמש ב-curl כדי להפעיל את כלי ה-MCP‏ insert_dimension.

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

סכימת הקלט

InsertDimensionRequest

ייצוג ב-JSON 
{
  "spreadsheetId": string,
  "sheetId": integer,
  "dimension": enum (Dimension),
  "startIndex": integer,
  "endIndex": integer,
  "inheritFromBefore": boolean
}
שדות
spreadsheetId

string

חובה. המזהה של הגיליון האלקטרוני שרוצים לעדכן.
sheetId

integer

חובה. המזהה של הגיליון שאליו רוצים להוסיף את הנתונים.
dimension

enum (Dimension)

חובה. המאפיין שרוצים להוסיף.
startIndex

integer

חובה. אינדקס ההתחלה של ההוספה, כשהספירה מתחילה מ-0 (כולל).
endIndex

integer

חובה. אינדקס הסיום של ההוספה, כשהספירה מתחילה מ-0 (לא כולל).
inheritFromBefore

boolean

אם צריך להרחיב את מאפייני המאפיינים מהמאפיינים שלפני או אחרי המאפיינים החדשים שנוספו. True כדי לרשת מהמאפיינים שלפני (במקרה כזה, אינדקס ההתחלה חייב להיות גדול מ-0), ו-False כדי לרשת מהמאפיינים שאחרי.

מאפיין

מציין על איזה מאפיין הפעולה צריכה לחול.

טיפוסים בני מנייה (enum)
DIMENSION_UNSPECIFIED ערך ברירת המחדל, לא לשימוש.
COLUMNS פועלת על העמודות בגיליון.
ROWS פועל על השורות בגיליון.

סכימת הפלט

InsertDimensionResponse

ייצוג ב-JSON 
{
  "content": {
    object
  }
}
שדות
content

object (Struct format)

התגובה של spreadsheets.batchUpdate, בפורמט JSON של Sheets API, בתוספת שדה status.

Struct

ייצוג ב-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

מייצג null ב-JSON.
numberValue

number

מייצג מספר ב-JSON. הערך לא יכול להיות NaN,‏ Infinity או -Infinity, כי אין להם תמיכה ב-JSON. הוא גם לא יכול לייצג ערכי Int64 גדולים, כי בדרך כלל פורמט JSON לא תומך בהם בסוג המספר שלו.
stringValue

string

מייצג מחרוזת JSON.
boolValue

boolean

מייצג ערך בוליאני של JSON (ליטרל true או false ב-JSON).
structValue

object (Struct format)

מייצג אובייקט JSON.
listValue

array (ListValue format)

מייצג מערך JSON.

ListValue

ייצוג ב-JSON 
{
  "values": [
    value
  ]
}
שדות
values[]

value (Value format)

שדה חוזר של ערכים שהוקלדו באופן דינמי.

NullValue

מייצג null ב-JSON.

‫NullValue הוא sentinel, שמשתמש ב-enum עם ערך אחד בלבד כדי לייצג את הערך null לאיחוד מסוג Value.

שדה מסוג NullValue עם ערך שונה מ-0 נחשב לא תקין. רוב ה-serializers של ProtoJSON יפיקו Value עם null_value שמוגדר כ-null של JSON, בלי קשר לערך של המספר השלם, ולכן יחזרו לערך 0.

טיפוסים בני מנייה (enum)
NULL_VALUE ערך Null.

הערות לגבי הכלים

הערות הכלים נשלחות ללקוחות MCP כדי לתאר את הסיכון הבסיסי של כלי מסוים. רוב הלקוחות מתייחסים לרמזים האלה כלא מהימנים, אבל אפשר להשתמש בהם כדי להחליט מתי לשלוח למשתמש בקשה לאישור.

בנוסף למחרוזת הכותרת, הרמזים הבוליאניים הבאים מוגדרים כך:

  • ‫readOnlyHint: אם הערך הוא True, הכלי לא משנה את הסביבה שלו. ברירת המחדל: false.
  • ‫destructiveHint: אם הערך הוא True, הכלי יכול לבצע פעולות הרסניות. אם הערך הוא False, הכלי יכול לבצע רק פעולות הוספה. ברירת המחדל: true.
  • ‫idempotentHint: אם הערך הוא True, קריאה חוזרת לכלי עם אותם ארגומנטים לא תשפיע על הסביבה שלו. ברירת המחדל: false.
  • ‫openWorldHint: אם הערך הוא True, הכלי יכול לקיים אינטראקציה עם "עולם פתוח" של ישויות חיצוניות. אם הערך הוא false, הכלי יכול לקיים אינטראקציה רק עם ישויות פנימיות. לדוגמה, כלי חיפוש באינטרנט הוא כלי בעולם פתוח, אבל כלי זיכרון הוא לא כלי בעולם פתוח.

רמז לפעולה הרסנית: ❌ | רמז לפעולה אידמפוטנטית: ❌ | רמז לפעולה לקריאה בלבד: ❌ | רמז לפעולה בעולם פתוח: ✅

היקפי הרשאות

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

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