MCP Tools Reference: sheetsmcp.googleapis.com

כלי: update_values

הפונקציה מגדירה ערכים בטווח של גיליון אלקטרוני. מקביל ל-spreadsheets.values.update ב-API בארכיטקטורת REST: ‏ https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update

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

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

סכימת הקלט

UpdateValuesRequest

ייצוג ב-JSON 
{
  "spreadsheetId": string,
  "range": string,
  "values": [
    array
  ]
}
שדות
spreadsheetId

string

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

string

חובה. הסימון A1 של הערכים לעדכון.
values[]

array (ListValue format)

חובה. הנתונים שנקראו או שייכתבו. זהו מערך של מערכים, כאשר המערך החיצוני מייצג את כל הנתונים וכל מערך פנימי מייצג שורה. כל פריט במערך הפנימי תואם לתא אחד. סוגי הערכים הנתמכים הם: bool,‏ string ו-double. המערכת תדלג על ערכי Null. כדי להגדיר תא עם ערך ריק, צריך להגדיר את ערך המחרוזת כמחרוזת ריקה.

ListValue

ייצוג ב-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 (הליטרלים true או false ב-JSON).
structValue

object (Struct format)

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

array (ListValue format)

מייצג מערך 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)

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.

הערות על כלים

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