MCP Tools Reference: sheetsmcp.googleapis.com

כלי: update_spreadsheet

הוספת עדכון אחד או יותר לגיליון האלקטרוני.

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

רשימת העדכונים האפשריים:

  • ‫updateSpreadsheetProperties: מעדכן את המאפיינים של הגיליון האלקטרוני.
  • ‫updateSheetProperties: עדכון המאפיינים של גיליון.
  • ‫updateDimensionProperties: עדכון המאפיינים של המאפיינים.
  • ‫updateNamedRange: עדכון של טווח תאים בעל שם.
  • ‫repeatCell: משכפלת תא יחיד בטווח.
  • ‫addNamedRange: הוספת טווח תאים בעל שם.
  • ‫deleteNamedRange: מחיקת טווח תאים בעל שם.
  • ‫addSheet: הוספת גיליון.
  • ‫deleteSheet: מחיקת גיליון.
  • ‫autoFill: מילוי אוטומטי של נתונים נוספים על סמך נתונים קיימים.
  • ‫cutPaste: חותך נתונים מאזור אחד ומדביק אותם באזור אחר.
  • ‫copyPaste: מעתיק נתונים מאזור אחד ומדביק אותם באזור אחר.
  • ‫mergeCells: מיזוג תאים.
  • ‫unmergeCells: ביטול המיזוג של תאים שמוזגו.
  • ‫updateBorders: מעדכנת את הגבולות בטווח של תאים.
  • ‫updateCells: עדכון של הרבה תאים בבת אחת.
  • ‫addFilterView: הוספת תצוגה מסוננת.
  • ‫appendCells: מוסיפה תאים אחרי השורה האחרונה שמכילה נתונים בגיליון.
  • ‫clearBasicFilter: מנקה את המסנן הבסיסי בגיליון.
  • ‫deleteDimension: מחיקת שורות או עמודות בגיליון.
  • ‫deleteEmbeddedObject: מחיקת אובייקט מוטמע (למשל, תרשים או תמונה) בגיליון.
  • ‫deleteFilterView: מחיקת תצוגה מסוננת מגיליון.
  • ‫duplicateFilterView: משכפל תצוגת מסנן.
  • ‫duplicateSheet: יצירת עותק משוכפל של גיליון.
  • ‫findReplace: מחפשת מופעים של טקסט מסוים ומחליפה אותם בטקסט אחר.
  • ‫insertDimension: מוסיף שורות או עמודות חדשות בגיליון.
  • ‫insertRange: מוסיף תאים חדשים בגיליון, ומזיז את התאים הקיימים.
  • ‫moveDimension: מעבירה שורות או עמודות למיקום אחר בגיליון.
  • ‫updateEmbeddedObjectPosition: עדכון המיקום של אובייקט מוטמע (למשל תרשים, תמונה).
  • ‫pasteData: מדביקה נתונים (HTML או נתונים מופרדים) בגיליון.
  • ‫textToColumns: ממירה עמודה של טקסט לכמה עמודות של טקסט.
  • ‫updateFilterView: עדכון המאפיינים של תצוגה מסוננת.
  • ‫deleteRange: מחיקת טווח של תאים מגיליון, והזזת התאים שנותרו.
  • ‫appendDimension: מוסיפה מאפיינים לסוף הגיליון.
  • ‫addConditionalFormatRule: מוסיפים כלל חדש של עיצוב מותנה.
  • ‫updateConditionalFormatRule: עדכון של כלל קיים של עיצוב מותנה.
  • ‫deleteConditionalFormatRule: מחיקת כלל קיים של עיצוב מותנה.
  • ‫sortRange: מיון נתונים בטווח.
  • setDataValidation: מגדירה אימות נתונים לתא אחד או יותר.
  • ‫setBasicFilter: הגדרת המסנן הבסיסי בגיליון.
  • ‫addProtectedRange: הוספת טווח תאים מוגן.
  • ‫updateProtectedRange: עדכון של טווח תאים מוגן.
  • ‫deleteProtectedRange: מחיקת טווח תאים מוגן.
  • ‫autoResizeDimensions: משנה את הגודל של מאפיין אחד או יותר באופן אוטומטי בהתאם לתוכן של התאים במאפיין הזה.
  • ‫addChart: הוספת תרשים.
  • ‫updateChartSpec: עדכון המפרט של תרשים.
  • ‫updateBanding: עדכון טווח עם פסים
  • ‫addBanding: הוספת טווח חדש עם פסים
  • ‫deleteBanding: הסרת טווח עם פסים
  • ‫createDeveloperMetadata: יצירת מטא-נתונים חדשים למפתחים
  • ‫updateDeveloperMetadata: עדכון של רשומה קיימת של מטא-נתונים של מפתח/ת
  • ‫deleteDeveloperMetadata: מחיקת מטא-נתונים של מפתחים
  • ‫randomizeRange: משנה את הסדר של השורות בטווח באופן אקראי.
  • ‫addDimensionGroup: יוצר קבוצה בטווח שצוין.
  • ‫deleteDimensionGroup: מחיקת קבוצה בטווח שצוין.
  • ‫updateDimensionGroup: מעדכן את המצב של הקבוצה שצוינה.
  • ‫trimWhitespace: חיתוך רווחים לבנים (כמו רווחים, טאבים או שורות חדשות) בתאים.
  • ‫deleteDuplicates: מסירה שורות שמכילות ערכים כפולים בעמודות שצוינו בטווח תאים.
  • ‫updateEmbeddedObjectBorder: עדכון הגבול של אובייקט מוטמע.
  • ‫addSlicer: הוספת כלי סינון.
  • ‫updateSlicerSpec: עדכון המפרטים של כלי פריסה.
  • ‫addDataSource: הוספת מקור נתונים.
  • ‫updateDataSource: מעדכן מקור נתונים.
  • ‫deleteDataSource: מחיקת מקור נתונים.
  • ‫refreshDataSource: מרעננת מקור נתונים אחד או יותר ואובייקטים של מסד נתונים שמשויכים אליהם.
  • ‫cancelDataSourceRefresh: מבטל רענון של מקור נתונים אחד או יותר ושל אובייקטים קשורים של מסד נתונים.
  • ‫addTable: הוספת טבלה.
  • ‫updateTable: עדכון טבלה.
  • ‫deleteTable: בקשה למחיקת טבלה.

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

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

סכימת הקלט

UpdateContentRequest

ייצוג ב-JSON 
{
  "spreadsheetId": string,
  "requests": [
    {
      object
    }
  ]
}
שדות
spreadsheetId

string

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

object (Struct format)

חובה. רשימת העדכונים שרוצים להחיל על הגיליון האלקטרוני. כל בקשה צריכה להיות אובייקט בקשה תקין של spreadsheets.batchUpdate, באמצעות הסכימה שמתועדת בכתובת: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/request הבקשות יחולו לפי הסדר שבו הן מצוינות. אם בקשה כלשהי לא תהיה תקפה, אף בקשה לא תתבצע.

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

ייצוג של JSON null.
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

ייצוג של JSON null.

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

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

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

סכימת הפלט

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

מיפוי לא מסודר של מפתח-ערך, שמטרתו לתעד בצורה מושלמת את הסמנטיקה של אובייקט JSON. כך אפשר לנתח כל מטען ייעודי (payload) של JSON שרירותי כשדה הודעה בפורמט ProtoJSON.

הפורמט הזה תואם להנחיות של RFC 8259 לגבי JSON שניתן להפעלה הדדית: חשוב לציין שאי אפשר לייצג באמצעות הסוג הזה ערכים גדולים של Int64 או מספרים של NaN/Infinity, כי פורמט JSON בדרך כלל לא תומך בערכים האלה בסוג המספרים שלו.

אם אתם לא מתכוונים לנתח JSON שרירותי בהודעה, עדיף להשתמש בהודעה מוקלדת מותאמת אישית במקום בסוג הזה.

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

ייצוג של JSON null.
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

ייצוג של JSON null.

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

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

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

הערות על כלים

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