MCP Tools Reference: slidesmcp.googleapis.com

כלי: update_presentation

מעדכן מצגת באמצעות קבוצה של בקשות batchUpdate.

תואם ל-presentations.batchUpdate ב-REST API.

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

  • ‫createSlide: יצירת שקף חדש.
  • ‫createShape: יצירת צורה חדשה.
  • ‫createTable: יצירת טבלה חדשה.
  • ‫insertText: הוספת טקסט לצורה או לתא בטבלה.
  • ‫insertTableRows: מוסיפה שורות לטבלה.
  • ‫insertTableColumns: הוספת עמודות לטבלה.
  • ‫deleteTableRow: מחיקת שורה מטבלה.
  • ‫deleteTableColumn: מחיקת עמודה מטבלה.
  • ‫replaceAllText: מחליף את כל המופעים של הטקסט שצוין.
  • ‫deleteObject: מחיקת דף או רכיב בדף מהמצגת.
  • ‫updatePageElementTransform: עדכון השינוי של רכיב בדף.
  • ‫updateSlidesPosition: מעדכנת את המיקום של קבוצת שקפים במצגת.
  • ‫deleteText: מחיקת טקסט מצורה או מתא בטבלה.
  • ‫createImage: יצירת תמונה.
  • ‫createVideo: יצירת סרטון.
  • ‫createSheetsChart: יוצר תרשים מוטמע של Google Sheets.
  • ‫createLine: יצירת קו.
  • ‫refreshSheetsChart: רענון של תרשים ב-Google Sheets.
  • ‫updateShapeProperties: עדכון המאפיינים של צורה.
  • ‫updateImageProperties: מעדכן את המאפיינים של תמונה.
  • ‫updateVideoProperties: מעדכן את המאפיינים של סרטון.
  • ‫updatePageProperties: עדכון המאפיינים של דף.
  • ‫updateTableCellProperties: מעדכן את המאפיינים של TableCell.
  • ‫updateLineProperties: מעדכן את המאפיינים של קו.
  • ‫createParagraphBullets: יוצר תבליטים לפסקאות.
  • ‫replaceAllShapesWithImage: מחליף את כל הצורות שתואמות לקריטריונים מסוימים בתמונה.
  • ‫duplicateObject: יוצר עותק משוכפל של שקף או של רכיב בדף.
  • ‫updateTextStyle: מעדכן את הסגנון של הטקסט בתוך צורה או טבלה.
  • ‫replaceAllShapesWithSheetsChart: מחליף את כל הצורות שתואמות לקריטריונים מסוימים בתרשים של Google Sheets.
  • deleteParagraphBullets: מחיקת תבליטים מפסקה.
  • ‫updateParagraphStyle: מעדכן את העיצוב של פסקאות בתוך צורה או טבלה.
  • ‫updateTableBorderProperties: מעדכן את המאפיינים של גבולות הטבלה בטבלה.
  • ‫updateTableColumnProperties: עדכון המאפיינים של עמודה בטבלה.
  • ‫updateTableRowProperties: מעדכן את המאפיינים של שורה בטבלה.
  • ‫mergeTableCells: ממזג תאים בטבלה.
  • ‫unmergeTableCells: ביטול המיזוג של תאים בטבלה.
  • ‫groupObjects: קיבוץ אובייקטים, כמו רכיבי דף.
  • ‫ungroupObjects: מבטל את הקיבוץ של אובייקטים, כמו קבוצות.
  • ‫updatePageElementAltText: מעדכן את הטקסט החלופי של הכותרת או התיאור של רכיב בדף.
  • ‫replaceImage: מחליף תמונה קיימת בתמונה חדשה.
  • ‫updateSlideProperties: עדכון המאפיינים של שקף.
  • ‫updatePageElementsZOrder: מעדכן את סדר השכבות של רכיבי הדף.
  • ‫importSlides: מייבא דף שקף אחד או יותר שצוינו ממצגת מקור למצגת הזו (מצגת היעד).
  • ‫updateLineCategory: עדכון הקטגוריה של שורה.
  • ‫rerouteLine: מעביר קו כך שהוא מחובר לשני אתרי החיבור הקרובים ביותר ברכיבי הדף המחוברים.
  • ‫createAudio: יצירת אודיו במצגת הזו.
  • ‫updateAudioProperties: מעדכן את המאפיינים של אודיו.

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

בקשת Curl 
curl --location 'https://slidesmcp.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "update_presentation",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

סכימת הקלט

שליחת בקשה לעדכון מצגת.

UpdatePresentationRequest

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

string

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

object (Struct format)

חובה. רשימה של בקשות batchUpdate, באמצעות הסכימה והסמנטיקה שמתועדות בכתובת https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/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

מייצג 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 הוא ערך שמירה, שמשתמש בערך מספרי עם ערך אחד בלבד כדי לייצג את ערך ה-null עבור איחוד הסוגים Value.

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

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

סכימת הפלט

עדכון התשובות של מצגת.

UpdatePresentationResponse

ייצוג JSON 
{
  "replies": [
    {
      object
    }
  ]
}
שדות
replies[]

object (Struct format)

קבוצה של תשובות batchUpdate, באמצעות הסכימה והסמנטיקה שמתועדות בכתובת https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/response

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 הוא ערך שמירה, שמשתמש בערך מספרי עם ערך אחד בלבד כדי לייצג את ערך ה-null עבור איחוד הסוגים Value.

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

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

הערות על כלים

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