MCP Reference: slidesmcp.googleapis.com

לקרוא ייצוג JSON של מצגת ב-Google Slides.

תואם ל-presentations.get ב-API בארכיטקטורת REST.

קריאת ייצוג JSON של שקף או דף יחיד ממצגת ב-Google Slides.

תואם ל-presentations.pages.get ב-API בארכיטקטורת REST.

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

תואם ל-presentations.pages.getThumbnail ב-API בארכיטקטורת REST.

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

תואם ל-presentations.batchUpdate ב-API בארכיטקטורת REST.

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

• ‫createSlide: יצירת שקף חדש. סכימה:
  • ‫objectId (מחרוזת, אופציונלי): מזהה אובייקט שסופק על ידי המשתמש. אם מציינים מזהה, הוא חייב להיות ייחודי (5-50 תווים, בתבנית [a-zA-Z0-9_-:]). אם לא מציינים מזהה, המערכת יוצרת אותו.
  • ‫insertionIndex (מספר שלם, אופציונלי): אינדקס שמתחיל מאפס ומציין את המיקום שבו צריך להוסיף את השקף. אם לא מציינים מיקום, התמונה מוכנסת בסוף.
  • ‫slideLayoutReference (object, optional): הפניה לפריסה של השקף שרוצים להוסיף (חובה לציין בדיוק אחת אם מציינים):
  • ‫predefinedLayout (string): שם פריסת ברירת המחדל (לדוגמה, 'BLANK',‏ 'TITLE_AND_BODY',‏ 'TITLE',‏ 'SECTION_HEADER',‏ 'SECTION_TITLE_AND_DESCRIPTION',‏ 'ONE_COLUMN_TEXT',‏ 'MAIN_POINT',‏ 'BIG_NUMBER',‏ 'TITLE_AND_TWO_COLUMNS').
  • ‫layoutId (מחרוזת): מזהה הפריסה מהפריסה הראשית הנוכחית.
  • ‫placeholderIdMappings (מערך אובייקטים, אופציונלי): מיפויים של פלייסהולדרים מפריסת השקף לשקף. כל פריט:
  • ‫layoutPlaceholder (אובייקט): {"type": string, "index": integer}.
  • ‫objectId (מחרוזת, חובה): מזהה האובייקט שסופק על ידי המשתמש עבור רכיב ה-placeholder.
• ‫createShape: יצירת צורה חדשה. סכימה:
  • ‫objectId (מחרוזת, אופציונלי): מזהה אובייקט שסופק על ידי המשתמש. אם לא מציינים מזהה, המערכת יוצרת מזהה.
  • ‫elementProperties (אובייקט, חובה): מיקום וגודל הרכיב:
  • ‫pageObjectId (מחרוזת, חובה): מזהה האובייקט של הדף שבו הצורה נמצאת.
  • ‫size (אובייקט, אופציונלי): {"width": {"magnitude": number, "unit": string}, "height": {"magnitude": number, "unit": string}} (יחידה: PT או EMU).
  • ‫transform (object, optional): AffineTransform {"scaleX": number, "scaleY": number, "shearX": number, "shearY": number, "translateX": number, "translateY": number, "unit": string}.
  • ‫shapeType (מחרוזת, חובה): סוג הצורה (לדוגמה, RECTANGLE,‏ ROUND_RECTANGLE,‏ ELLIPSE,‏ TEXT_BOX,‏ LINE וכו').
• ‫createTable: יצירת טבלה חדשה. סכימה:
  • ‫objectId (מחרוזת, אופציונלי): מזהה אובייקט שסופק על ידי המשתמש. אם לא מציינים מזהה, המערכת יוצרת מזהה.
  • ‫elementProperties (אובייקט, חובה): מיקום וגודל הרכיב:
  • ‫pageObjectId (מחרוזת, חובה): מזהה האובייקט של הדף שבו הטבלה נמצאת.
  • ‫size (אובייקט, אופציונלי): {"width": {"magnitude": number, "unit": string}, "height": {"magnitude": number, "unit": string}}.
  • ‫transform (object, optional): AffineTransform {"scaleX": number, "scaleY": number, "shearX": number, "shearY": number, "translateX": number, "translateY": number, "unit": string}.
  • ‫rows (מספר שלם, חובה): מספר השורות בטבלה.
  • ‫columns (מספר שלם, חובה): מספר העמודות בטבלה.
• ‫insertText: מוסיף טקסט לצורה או לתא בטבלה. סכימה:
  • ‫objectId (מחרוזת, חובה): מזהה האובייקט של הצורה או הטבלה.
  • ‫cellLocation (object, optional): Table cell if inserting into table: {"rowIndex": integer, "columnIndex": integer}.
  • ‫text (מחרוזת, חובה): הטקסט שרוצים להוסיף.
  • ‫insertionIndex (מספר שלם, אופציונלי): אינדקס של התו שמתחיל מ-0, שבו הטקסט יתווסף. ברירת המחדל היא 0.
• ‫insertTableRows: הוספת שורות לטבלה. סכימה:
  • ‫tableObjectId (מחרוזת, חובה): מזהה האובייקט של הטבלה.
  • ‫cellLocation (אובייקט, חובה): מיקום תא ההפניה: {"rowIndex": integer, "columnIndex": integer}.
  • ‫insertBelow (בוליאני, חובה): האם להוסיף שורות חדשות מתחת לתא ההפניה.
  • ‫number (מספר שלם, חובה): מספר השורות להוספה (מקסימום 20).
• ‫insertTableColumns: מוסיף עמודות לטבלה. סכימה:
  • ‫tableObjectId (מחרוזת, חובה): מזהה האובייקט של הטבלה.
  • ‫cellLocation (אובייקט, חובה): מיקום תא ההפניה: {"rowIndex": integer, "columnIndex": integer}.
  • ‫insertRight (boolean, חובה): האם להוסיף עמודות חדשות מימין לתא ההפניה.
  • ‫number (מספר שלם, חובה): מספר העמודות להוספה (מקסימום 20).
• ‫deleteTableRow: מחיקת שורה מטבלה. סכימה:
  • ‫tableObjectId (מחרוזת, חובה): מזהה האובייקט של הטבלה.
  • ‫cellLocation (אובייקט, חובה): מיקום תא ההפניה: {"rowIndex": integer, "columnIndex": integer}. מחיקת השורה שמכילה את התא הזה.
• ‫deleteTableColumn: מחיקת עמודה מטבלה. סכימה:
  • ‫tableObjectId (מחרוזת, חובה): מזהה האובייקט של הטבלה.
  • ‫cellLocation (אובייקט, חובה): מיקום תא ההפניה: {"rowIndex": integer, "columnIndex": integer}. מוחק את העמודה שמכילה את התא הזה.
• ‫replaceAllText: מחליפה את כל המופעים של טקסט שצוין. סכימה:
  • ‫replaceText (מחרוזת, חובה): טקסט ההחלפה.
  • ‫containsText (object, required): קריטריונים להתאמת טקסט:
  • ‫text (מחרוזת, חובה): הטקסט שמחפשים.
  • ‫matchCase (boolean, optional): Whether search is case-sensitive.
  • ‫pageObjectIds (מערך של מחרוזות, אופציונלי): אם מציינים את הפרמטר הזה, ההחלפה מוגבלת לרכיבים בדפים האלה.
• ‫deleteObject: מחיקת דף או רכיב בדף מהמצגת. סכימה:
  • ‫objectId (מחרוזת, חובה): מזהה האובייקט של הדף או של רכיב הדף שרוצים למחוק.
• ‫updatePageElementTransform: עדכון השינוי של רכיב בדף. סכימה:
  • ‫objectId (מחרוזת, חובה): מזהה האובייקט של רכיב הדף שרוצים לעדכן.
  • ‫transform (object, required): AffineTransform {"scaleX": number, "scaleY": number, "shearX": number, "shearY": number, "translateX": number, "translateY": number, "unit": string}.
  • ‫applyMode (מחרוזת, חובה): מצב ההחלה של הטרנספורמציה: RELATIVE או ABSOLUTE.
• ‫updateSlidesPosition: מעדכן את המיקום של קבוצת שקפים במצגת. סכימה:
  • ‫slideObjectIds (מערך של מחרוזות, חובה): מזהי האובייקטים של השקפים שרוצים להעביר.
  • ‫insertionIndex (מספר שלם, חובה): אינדקס שמתחיל בספרה אפס, שבו יתווספו השקפים.
• ‫deleteText: מחיקת טקסט מצורה או מתא בטבלה. סכימה:
  • ‫objectId (מחרוזת, חובה): מזהה האובייקט של הצורה או הטבלה.
  • ‫cellLocation (אובייקט, אופציונלי): תא בטבלה אם מוחקים מהטבלה: {"rowIndex": integer, "columnIndex": integer}.
  • ‫textRange (אובייקט, אופציונלי): {"startIndex": integer, "endIndex": integer, "type": string}. אם לא מציינים טקסט, כל הטקסט נמחק.
• ‫createImage: יצירת תמונה. סכימה:
  • ‫objectId (מחרוזת, אופציונלי): מזהה אובייקט שסופק על ידי המשתמש. אם לא מציינים מזהה, המערכת יוצרת מזהה.
  • ‫url (מחרוזת, חובה): כתובת ה-URL של התמונה לאחזור ולאחסון. הקישור צריך להיות לכתובת שלכולם יש אליה גישה.
  • ‫elementProperties (אובייקט, חובה): מיקום וגודל הרכיב:
  • ‫pageObjectId (מחרוזת, חובה): מזהה האובייקט של הדף שבו התמונה תוצב.
  • ‫size (אובייקט, אופציונלי): {"width": {"magnitude": number, "unit": string}, "height": {"magnitude": number, "unit": string}}.
  • ‫transform (object, optional): AffineTransform {"scaleX": number, "scaleY": number, "shearX": number, "shearY": number, "translateX": number, "translateY": number, "unit": string}.
• ‫createVideo: יצירת סרטון. סכימה:
  • ‫objectId (מחרוזת, אופציונלי): מזהה אובייקט שסופק על ידי המשתמש. אם לא מציינים מזהה, המערכת יוצרת מזהה.
  • ‫source (מחרוזת, חובה): מקור הסרטון: YOUTUBE או DRIVE.
  • ‫id (מחרוזת, חובה): מזהה הסרטון (למשל מזהה סרטון ב-YouTube).
  • ‫elementProperties (אובייקט, חובה): מיקום וגודל הרכיב:
  • ‫pageObjectId (מחרוזת, חובה): מזהה האובייקט של הדף שבו הסרטון יוצג.
  • ‫size (אובייקט, אופציונלי): {"width": {"magnitude": number, "unit": string}, "height": {"magnitude": number, "unit": string}}.
  • ‫transform (object, optional): AffineTransform {"scaleX": number, "scaleY": number, "shearX": number, "shearY": number, "translateX": number, "translateY": number, "unit": string}.
• ‫createSheetsChart: יוצר תרשים מוטמע של Google Sheets. סכימה:
  • ‫objectId (מחרוזת, אופציונלי): מזהה אובייקט שסופק על ידי המשתמש. אם לא מציינים מזהה, המערכת יוצרת מזהה.
  • ‫spreadsheetId (מחרוזת, חובה): המזהה של הגיליון האלקטרוני ב-Google Sheets שמכיל את התרשים.
  • ‫chartId (מספר שלם, חובה): מזהה התרשים הספציפי בגיליון האלקטרוני.
  • ‫linkingMode (מחרוזת, חובה): מצב הקישור: LINKED או NOT_LINKED_IMAGE.
  • ‫elementProperties (אובייקט, חובה): מיקום וגודל הרכיב:
  • ‫pageObjectId (מחרוזת, חובה): מזהה האובייקט של הדף שבו יוצב התרשים.
  • ‫size (אובייקט, אופציונלי): {"width": {"magnitude": number, "unit": string}, "height": {"magnitude": number, "unit": string}}.
  • ‫transform (object, optional): AffineTransform {"scaleX": number, "scaleY": number, "shearX": number, "shearY": number, "translateX": number, "translateY": number, "unit": string}.
• ‫createLine: יצירת קו. סכימה:
  • ‫objectId (מחרוזת, אופציונלי): מזהה אובייקט שסופק על ידי המשתמש. אם לא מציינים מזהה, המערכת יוצרת מזהה.
  • ‫elementProperties (אובייקט, חובה): מיקום וגודל הרכיב:
  • ‫pageObjectId (מחרוזת, חובה): מזהה האובייקט של הדף שבו יוצב הפריט.
  • ‫size (אובייקט, אופציונלי): {"width": {"magnitude": number, "unit": string}, "height": {"magnitude": number, "unit": string}}.
  • ‫transform (object, optional): AffineTransform {"scaleX": number, "scaleY": number, "shearX": number, "shearY": number, "translateX": number, "translateY": number, "unit": string}.
  • ‫category (מחרוזת, חובה): קטגוריית הקו: STRAIGHT,‏ BENT או CURVED.
• ‫refreshSheetsChart: מרענן תרשים ב-Google Sheets. סכימה:
  • ‫objectId (מחרוזת, חובה): מזהה האובייקט של התרשים לרענון.
• ‫updateShapeProperties: מעדכן את המאפיינים של צורה. סכימה:
  • ‫objectId (מחרוזת, חובה): מזהה האובייקט של הצורה שרוצים לעדכן.
  • ‫shapeProperties (object, required): מאפייני הצורה לעדכון:
  • ‫shapeBackgroundFill (אובייקט, אופציונלי): {"solidFill": {"color": {"rgbColor": {"red": number, "green": number, "blue": number}}}}.
  • ‫outline (אובייקט, אופציונלי): {"outlineFill": {"solidFill": ...}, "weight": {"magnitude": number, "unit": string}, "dashStyle": string}.
  • ‫shadow (object, optional): מאפייני צל.
  • ‫link (אובייקט, אופציונלי): יעד ההיפר-קישור: {"url": string}.
  • ‫fields (מחרוזת, חובה): רשימה מופרדת בפסיקים של השדות לעדכון (לדוגמה, "shapeBackgroundFill" או "*").
• ‫updateImageProperties: עדכון המאפיינים של תמונה. סכימה:
  • ‫objectId (מחרוזת, חובה): מזהה האובייקט של התמונה שרוצים לעדכן.
  • ‫imageProperties (object, required): מאפייני התמונה לעדכון:
  • ‫cropProperties (object, optional): Crop offsets: {"leftOffset": number, "rightOffset": number, "topOffset": number, "bottomOffset": number, "angle": number}.
  • ‫transparency (מספר, אופציונלי): רמת השקיפות (0.0 עד 1.0).
  • ‫brightness (מספר, אופציונלי): התאמת הבהירות (מ-1.0- עד 1.0).
  • ‫contrast (מספר, אופציונלי): התאמת הניגודיות (מ-1.0 עד 1.0).
  • ‫recolor (object, optional): Recolor effect.
  • ‫shadow (object, optional): מאפייני צל.
  • ‫outline (אובייקט, אופציונלי): מאפייני המתאר.
  • ‫link (אובייקט, אופציונלי): יעד ההיפר-קישור: {"url": string}.
  • ‫fields (מחרוזת, חובה): רשימה מופרדת בפסיקים של השדות לעדכון (לדוגמה, "transparency,brightness" או "*").
• ‫updateVideoProperties: מעדכן את המאפיינים של סרטון. סכימה:
  • ‫objectId (מחרוזת, חובה): מזהה האובייקט של הסרטון שרוצים לעדכן.
  • ‫videoProperties (object, required): מאפייני הווידאו לעדכון:
  • ‫outline (אובייקט, אופציונלי): מאפייני המתאר.
  • ‫autoPlay (בוליאני, אופציונלי): האם להפעיל את הסרטון באופן אוטומטי בזמן ההצגה.
  • ‫start (מספר שלם, אופציונלי): שעת התחלה בשניות.
  • ‫end (מספר שלם, אופציונלי): שעת הסיום בשניות.
  • ‫mute (boolean, optional): Whether audio is muted.
  • ‫fields (מחרוזת, חובה): רשימה מופרדת בפסיקים של השדות לעדכון (לדוגמה, "autoPlay,mute" או "*").
• ‫updatePageProperties: עדכון המאפיינים של דף. סכימה:
  • ‫objectId (מחרוזת, חובה): מזהה האובייקט של הדף שרוצים לעדכן.
  • ‫pageProperties (object, required): מאפייני הדף לעדכון:
  • ‫pageBackgroundFill (אובייקט, אופציונלי): {"solidFill": {"color": {"rgbColor": {"red": number, "green": number, "blue": number}}}} או {"stretchedPictureFill": {"contentUrl": string}}.
  • ‫colorScheme (אובייקט, אופציונלי): ערכת הצבעים של העיצוב.
  • ‫fields (מחרוזת, חובה): רשימה מופרדת בפסיקים של השדות לעדכון (לדוגמה, "pageBackgroundFill" או "*").
• ‫updateTableCellProperties: מעדכן את המאפיינים של TableCell. סכימה:
  • ‫objectId (מחרוזת, חובה): מזהה האובייקט של הטבלה.
  • ‫tableRange (אובייקט, אופציונלי): קבוצת משנה של תאי הטבלה לעדכון: {"location": {"rowIndex": integer, "columnIndex": integer}, "rowSpan": integer, "columnSpan": integer}. אם לא מציינים ערך, ההגדרה חלה על כל התאים.
  • ‫tableCellProperties (object, required): מאפייני התא לעדכון:
  • ‫tableCellBackgroundFill (אובייקט, אופציונלי): {"solidFill": {"color": {"rgbColor": {"red": number, "green": number, "blue": number}}}}.
  • ‫contentAlignment (מחרוזת, אופציונלי): יישור אנכי: 'TOP',‏ 'MIDDLE',‏ 'BOTTOM'.
  • ‫fields (מחרוזת, חובה): רשימה מופרדת בפסיקים של השדות לעדכון (לדוגמה, "tableCellBackgroundFill" או "*").
• ‫updateLineProperties: מעדכן את המאפיינים של קו. סכימה:
  • ‫objectId (מחרוזת, חובה): מזהה האובייקט של השורה לעדכון.
  • ‫lineProperties (object, required): מאפייני השורה לעדכון:
  • ‫lineFill (אובייקט, אופציונלי): {"solidFill": {"color": {"rgbColor": {"red": number, "green": number, "blue": number}}}}.
  • ‫weight (object, optional): Line thickness: {"magnitude": number, "unit": string}.
  • ‫dashStyle (מחרוזת, אופציונלי): סגנון קו מקווקו: SOLID,‏ DOT,‏ DASH,‏ DASH_DOT,‏ LONG_DASH,‏ LONG_DASH_DOT.
  • ‫startArrow (string, optional): סגנון חץ ההתחלה: NONE,‏ STEALTH_ARROW,‏ FILL_ARROW,‏ FILL_CIRCLE,‏ FILL_SQUARE,‏ FILL_DIAMOND,‏ OPEN_ARROW,‏ OPEN_CIRCLE,‏ OPEN_SQUARE,‏ OPEN_DIAMOND.
  • ‫endArrow (מחרוזת, אופציונלי): סגנון חץ הסיום (אותן אפשרויות כמו startArrow).
  • ‫link (אובייקט, אופציונלי): יעד ההיפר-קישור: {"url": string}.
  • ‫fields (מחרוזת, חובה): רשימה מופרדת בפסיקים של השדות לעדכון (לדוגמה, "lineFill,weight" או "*").
• ‫createParagraphBullets: יוצר תבליטים לפסקאות. סכימה:
  • ‫objectId (מחרוזת, חובה): מזהה האובייקט של הצורה או הטבלה.
  • ‫cellLocation (object, optional): Table cell if text is in a table: {"rowIndex": integer, "columnIndex": integer}.
  • ‫textRange (object, optional): Range of text to bullet: {"startIndex": integer, "endIndex": integer, "type": string}.
  • ‫bulletPreset (string, optional): קביעה מראש של סגנון תבליטים (לדוגמה, 'BULLET_DISC_CIRCLE_SQUARE',‏ 'BULLET_DIAMONDX_ARROW3D_SQUARE',‏ 'NUMBERED_DIGIT_ALPHA_ROMAN',‏ 'NUMBERED_DIGIT_NESTED'). ברירת המחדל היא BULLET_DISC_CIRCLE_SQUARE.
• ‫replaceAllShapesWithImage: מחליף את כל הצורות שתואמות לקריטריונים מסוימים בתמונה. סכימה:
  • ‫imageUrl (מחרוזת, חובה): כתובת ה-URL של התמונה לאחזור ולהוספה.
  • ‫imageReplaceMethod (מחרוזת, אופציונלי): שיטת ההחלפה: CENTER_INSIDE (ברירת מחדל) או CENTER_CROP.
  • ‫containsText (object, required): הצורות של הקריטריונים צריכות להיות זהות:
  • ‫text (מחרוזת, חובה): הטקסט שמחפשים בצורות.
  • ‫matchCase (boolean, optional): Whether search is case-sensitive.
  • ‫pageObjectIds (מערך של מחרוזות, אופציונלי): אם מציינים את הפרמטר הזה, ההחלפה מוגבלת לרכיבים בדפים האלה.
• ‫duplicateObject: יוצר עותק משוכפל של שקף או של רכיב בדף. סכימה:
  • ‫objectId (מחרוזת, חובה): מזהה האובייקט של השקף או הרכיב שרוצים לשכפל.
  • ‫objectIds (object, optional): מיפוי מזהים של רכיבים כפולים: {"originalObjectId": "newObjectId"}. אם לא מציינים מזהה, מוקצים מזהים אקראיים.
• ‫updateTextStyle: מעדכן את העיצוב של הטקסט בתוך צורה או טבלה. סכימה:
  • ‫objectId (מחרוזת, חובה): מזהה האובייקט של הצורה או הטבלה.
  • ‫cellLocation (object, optional): Table cell if text is in a table: {"rowIndex": integer, "columnIndex": integer}.
  • ‫style (object, required): מאפייני סגנון הטקסט:
  • ‫bold (ערך בוליאני, אופציונלי): האם הטקסט מודגש.
  • ‫italic (boolean, optional): Whether text is italic.
  • ‫fontFamily (מחרוזת, אופציונלי): משפחת הגופנים (לדוגמה, 'Arial',‏ 'Roboto').
  • ‫fontSize (object, optional): גודל הגופן: {"magnitude": number, "unit": string}.
  • ‫foregroundColor (object, optional): Font color: {"opaqueColor": {"rgbColor": {"red": number, "green": number, "blue": number}}}.
  • ‫backgroundColor (object, optional): צבע הרקע של הטקסט: {"opaqueColor": ...}.
  • ‫underline (boolean, optional): Whether text is underlined.
  • ‫strikethrough (בוליאני, אופציונלי): האם הטקסט כולל קו חוצה.
  • ‫smallCaps (ערך בוליאני, אופציונלי): מציין אם הטקסט מוצג באותיות רישיות קטנות.
  • ‫baselineOffset (string, optional): ‏"NONE",‏ "SUPERSCRIPT" או "SUBSCRIPT".
  • ‫link (אובייקט, אופציונלי): יעד ההיפר-קישור: {"url": string}.
  • ‫textRange (object, optional): Range of text to style: {"startIndex": integer, "endIndex": integer, "type": string}. אם לא מציינים ערך, התכונה חלה על כל הטקסט.
  • ‫fields (מחרוזת, חובה): רשימה מופרדת בפסיקים של השדות לעדכון (לדוגמה, "bold,foregroundColor" או "*").
• ‫replaceAllShapesWithSheetsChart: מחליף את כל הצורות שתואמות לקריטריונים מסוימים בתרשים של Google Sheets. סכימה:
  • ‫spreadsheetId (מחרוזת, חובה): המזהה של הגיליון האלקטרוני ב-Google Sheets שמכיל את התרשים.
  • ‫chartId (מספר שלם, חובה): מזהה התרשים הספציפי בגיליון האלקטרוני.
  • ‫linkingMode (מחרוזת, חובה): מצב הקישור: LINKED או NOT_LINKED_IMAGE.
  • ‫containsText (object, required): הצורות של הקריטריונים צריכות להיות זהות:
  • ‫text (מחרוזת, חובה): הטקסט שמחפשים בצורות.
  • ‫matchCase (boolean, optional): Whether search is case-sensitive.
  • ‫pageObjectIds (מערך של מחרוזות, אופציונלי): אם מציינים את הפרמטר הזה, ההחלפה מוגבלת לרכיבים בדפים האלה.
• deleteParagraphBullets: מחיקת תבליטים מפסקאות. סכימה:
  • ‫objectId (מחרוזת, חובה): מזהה האובייקט של הצורה או הטבלה שמכילות טקסט.
  • ‫cellLocation (object, optional): Table cell if text is in a table: {"rowIndex": integer, "columnIndex": integer}.
  • ‫textRange (אובייקט, אופציונלי): טווח הטקסט שממנו רוצים למחוק את התבליטים: {"startIndex": integer, "endIndex": integer, "type": string}.
• ‫updateParagraphStyle: מעדכן את הסגנון של פסקאות בתוך צורה או טבלה. סכימה:
  • ‫objectId (מחרוזת, חובה): מזהה האובייקט של הצורה או הטבלה.
  • ‫cellLocation (object, optional): Table cell if text is in a table: {"rowIndex": integer, "columnIndex": integer}.
  • ‫style (object, required): מאפייני סגנון הפסקה:
  • ‫alignment (string, optional): יישור הטקסט: START,‏ CENTER,‏ END,‏ JUSTIFIED.
  • ‫lineSpacing (מספר, אופציונלי): אחוז המרווח בין השורות (למשל, 100 ל-100%).
  • ‫spaceAbove (אובייקט, אופציונלי): רווח מעל הפסקה: {"magnitude": number, "unit": string}.
  • ‫spaceBelow (אובייקט, אופציונלי): רווח מתחת לפסקה: {"magnitude": number, "unit": string}.
  • ‫indentFirstLine (object, optional): First line indent: {"magnitude": number, "unit": string}.
  • ‫indentStart (object, optional): Indent at start: {"magnitude": number, "unit": string}.
  • ‫indentEnd (object, optional): Indent at end: {"magnitude": number, "unit": string}.
  • ‫direction (מחרוזת, אופציונלי): כיוון הטקסט: LEFT_TO_RIGHT או RIGHT_TO_LEFT.
  • ‫spacingMode (string, optional): מצב הריווח: NEVER_COLLAPSE או COLLAPSE_LISTS.
  • ‫textRange (object, optional): Range of text to style: {"startIndex": integer, "endIndex": integer, "type": string}. אם לא מציינים ערך, התכונה חלה על כל הטקסט.
  • ‫fields (מחרוזת, חובה): רשימה מופרדת בפסיקים של השדות לעדכון (לדוגמה, "alignment,lineSpacing" או "*").
• ‫updateTableBorderProperties: מעדכן את המאפיינים של גבולות הטבלה בטבלה. סכימה:
  • ‫objectId (מחרוזת, חובה): מזהה האובייקט של הטבלה.
  • ‫tableRange (אובייקט, אופציונלי): קבוצת משנה של גבולות הטבלה לעדכון: {"location": {"rowIndex": integer, "columnIndex": integer}, "rowSpan": integer, "columnSpan": integer}. אם לא מציינים ערך, התכונה חלה על כל הטבלה.
  • ‫borderPosition (מחרוזת, חובה): מיקום הגבול: ALL,‏ BOTTOM,‏ INNER,‏ INNER_HORIZONTAL,‏ INNER_VERTICAL,‏ LEFT,‏ OUTER,‏ RIGHT,‏ TOP.
  • ‫tableBorderProperties (object, required): מאפייני הגבול לעדכון:
  • ‫tableBorderFill (אובייקט, אופציונלי): {"solidFill": {"color": {"rgbColor": {"red": number, "green": number, "blue": number}}}}.
  • ‫weight (אובייקט, אופציונלי): עובי הגבול: {"magnitude": number, "unit": string}.
  • ‫dashStyle (מחרוזת, אופציונלי): סגנון קו מקווקו: SOLID,‏ DOT,‏ DASH.
  • ‫fields (מחרוזת, חובה): רשימה מופרדת בפסיקים של השדות לעדכון (לדוגמה, "tableBorderFill,weight" או "*").
• ‫updateTableColumnProperties: מעדכן את המאפיינים של עמודה בטבלה. סכימה:
  • ‫objectId (מחרוזת, חובה): מזהה האובייקט של הטבלה.
  • ‫columnIndices (מערך של מספרים שלמים, חובה): אינדקסים מבוססי-אפס של העמודות לעדכון.
  • ‫tableColumnProperties (object, required): מאפייני העמודה:
  • ‫columnWidth (אובייקט, אופציונלי): רוחב העמודה: {"magnitude": number, "unit": string}.
  • ‫fields (מחרוזת, חובה): רשימה מופרדת בפסיקים של השדות לעדכון (לדוגמה, "columnWidth" או "*").
• ‫updateTableRowProperties: מעדכן את המאפיינים של שורה בטבלה. סכימה:
  • ‫objectId (מחרוזת, חובה): מזהה האובייקט של הטבלה.
  • ‫rowIndices (מערך של מספרים שלמים, חובה): אינדקסים מבוססי-אפס של השורות לעדכון.
  • ‫tableRowProperties (object, required): מאפייני השורה:
  • ‫minRowHeight (object, optional): Minimum row height: {"magnitude": number, "unit": string}.
  • ‫fields (מחרוזת, חובה): רשימה מופרדת בפסיקים של השדות לעדכון (לדוגמה, "minRowHeight" או "*").
• ‫mergeTableCells: מיזוג תאים בטבלה. סכימה:
  • ‫objectId (מחרוזת, חובה): מזהה האובייקט של הטבלה.
  • ‫tableRange (אובייקט, חובה): טווח התאים למיזוג: {"location": {"rowIndex": integer, "columnIndex": integer}, "rowSpan": integer, "columnSpan": integer}.
• ‫unmergeTableCells: ביטול המיזוג של תאים בטבלה. סכימה:
  • ‫objectId (מחרוזת, חובה): מזהה האובייקט של הטבלה.
  • ‫tableRange (אובייקט, חובה): טווח התאים לביטול המיזוג: {"location": {"rowIndex": integer, "columnIndex": integer}, "rowSpan": integer, "columnSpan": integer}.
• ‫groupObjects: קיבוץ אובייקטים, כמו רכיבי דף. סכימה:
  • ‫groupObjectId (מחרוזת, אופציונלי): מזהה אובייקט שסופק על ידי המשתמש עבור הקבוצה. אם לא מציינים מזהה, המערכת יוצרת מזהה.
  • ‫childrenObjectIds (מערך של מחרוזות, חובה): מזהי האובייקטים של הרכיבים לקבוצה (נדרשים לפחות 2, באותו דף, שלא כבר מקובצים).
• ‫ungroupObjects: מבטל את הקיבוץ של אובייקטים, כמו קבוצות. סכימה:
  • ‫objectIds (מערך של מחרוזות, חובה): מזהי האובייקטים של הקבוצות שרוצים לבטל את הקיבוץ שלהן.
• ‫updatePageElementAltText: מעדכן את הטקסט החלופי של הכותרת או התיאור של רכיב בדף. סכימה:
  • ‫objectId (מחרוזת, חובה): מזהה האובייקט של רכיב הדף.
  • ‫title (מחרוזת, אופציונלי): הטקסט החלופי המעודכן של שם התמונה.
  • ‫description (מחרוזת, אופציונלי): תיאור הטקסט החלופי המעודכן.
• ‫replaceImage: מחליף תמונה קיימת בתמונה חדשה. סכימה:
  • ‫imageObjectId (מחרוזת, חובה): מזהה האובייקט של התמונה הקיימת שרוצים להחליף.
  • ‫url (מחרוזת, חובה): כתובת ה-URL של התמונה החדשה.
  • ‫imageReplaceMethod (מחרוזת, אופציונלי): שיטת ההחלפה: CENTER_INSIDE (ברירת מחדל) או CENTER_CROP.
• ‫updateSlideProperties: עדכון המאפיינים של שקף. סכימה:
  • ‫objectId (מחרוזת, חובה): מזהה האובייקט של השקף שרוצים לעדכן.
  • ‫slideProperties (object, required): מאפייני השקף:
  • ‫isSkipped (boolean, optional): Whether the slide is skipped in presentation mode.
  • ‫fields (מחרוזת, חובה): רשימה מופרדת בפסיקים של השדות לעדכון (לדוגמה, "isSkipped" או "*").
• ‫updatePageElementsZOrder: עדכון סדר ה-Z של רכיבי הדף. סכימה:
  • ‫pageElementObjectIds (מערך של מחרוזות, חובה): מזהי אובייקטים של רכיבי דף שצריך לעדכן (חייבים להיות באותו דף, לא מקובצים).
  • ‫operation (string, required): פעולת Z-order:‏ BRING_TO_FRONT,‏ BRING_FORWARD,‏ SEND_BACKWARD,‏ SEND_TO_BACK.
• ‫importSlides: מייבא דפי שקפים שצוינו ממצגת מקור למצגת הזו (מצגת היעד). סכימה:
  • ‫sourcePresentationId (מחרוזת, חובה): מזהה של מצגת המקור.
  • ‫importIndex (מספר שלם, אופציונלי): אינדקס שמתחיל מאפס, שבו יתבצע ייבוא השקפים. אם לא מציינים את התאריך, הייבוא מתבצע בסוף.
  • ‫sourceSlides (מערך של אובייקטים, אופציונלי): מיפויי מזהי שקפים: [{"sourceSlideObjectId": string, "destinationObjectIds": {"sourceObjectId": "destinationObjectId"}}]. אם לא מציינים ערך, כל השקפים מיובאים.
  • ‫preserveTheme (מחרוזת, אופציונלי): מדיניות שימור העיצוב: USE_SOURCE_THEME או USE_DESTINATION_THEME.
• ‫updateLineCategory: מעדכן את הקטגוריה של שורה. סכימה:
  • ‫objectId (מחרוזת, חובה): מזהה האובייקט של קו המחבר שרוצים לעדכן.
  • ‫lineCategory (מחרוזת, חובה): קטגוריית הקו: STRAIGHT,‏ BENT או CURVED.
• ‫rerouteLine: משנה את המסלול של קו כך שהוא יתחבר לשני אתרי החיבור הקרובים ביותר ברכיבי הדף המחוברים. סכימה:
  • ‫objectId (מחרוזת, חובה): מזהה האובייקט של קו המחבר לניתוב מחדש.
• ‫createAudio: יצירת אודיו במצגת הזו. סכימה:
  • ‫objectId (מחרוזת, אופציונלי): מזהה אובייקט שסופק על ידי המשתמש. אם לא מציינים מזהה, המערכת יוצרת מזהה.
  • ‫source (מחרוזת, חובה): מקור האודיו: DRIVE.
  • ‫sourceAudioId (מחרוזת, חובה): מזהה של קובץ האודיו ב-Google Drive.
  • ‫elementProperties (אובייקט, חובה): מיקום וגודל הרכיב:
  • ‫pageObjectId (מחרוזת, חובה): מזהה האובייקט של הדף שבו ימוקם האודיו.
  • ‫size (אובייקט, אופציונלי): {"width": {"magnitude": number, "unit": string}, "height": {"magnitude": number, "unit": string}}.
  • ‫transform (object, optional): AffineTransform {"scaleX": number, "scaleY": number, "shearX": number, "shearY": number, "translateX": number, "translateY": number, "unit": string}.
• ‫updateAudioProperties: מעדכן את המאפיינים של אודיו. סכימה:
  • ‫objectId (מחרוזת, חובה): מזהה האובייקט של האודיו שרוצים לעדכן.
  • ‫audioProperties (object, required): Audio properties:
  • ‫playbackVolume (מספר שלם, אופציונלי): עוצמת הקול של ההפעלה, מ-0 עד 100.
  • ‫repeat (boolean, optional): Whether to repeat playback indefinitely while presenting.
  • ‫showWhenPresenting (boolean, optional): מציין אם קליפ האודיו צריך להיות מוצג באופן גלוי במהלך ההצגה.
  • ‫playAcrossSlides (boolean, optional): Whether audio continues to play across slides.
  • ‫fields (מחרוזת, חובה): רשימה מופרדת בפסיקים של השדות לעדכון (לדוגמה, "playbackVolume,repeat" או "*").
• ‫insertComment: מוסיף הערה למצגת. סכימה:
  • content (מחרוזת, חובה): תוכן ההערה בטקסט פשוט.
  • מודעת עוגן (נדרשת בדיוק אחת):
  • ‫shapeTextAnchor (אובייקט): כדי להצמיד לטקסט בתוך צורה:
    • ‫shapeId (מחרוזת, חובה): מזהה האובייקט של הצורה.
    • ‫textRange (אובייקט, אופציונלי): {"startIndex": int, "endIndex": int}.
  • ‫objectId (מחרוזת): כדי ליצור עוגן לדף או לרכיב.
• ‫addCommentReply: מוסיפים תשובה לתגובה קיימת. סכימה:
  • ‫commentId (מחרוזת, חובה): המזהה של שרשור התגובות.
  • ‫post (אובייקט, חובה): {"content": "reply text"}.
• ‫updateCommentPost: מעדכן את התוכן של פוסט עם תגובה בשרשור תגובות. סכימה:
  • ‫commentId (מחרוזת, חובה): המזהה של שרשור התגובות.
  • ‫postId (מחרוזת, חובה): המזהה של פוסט התגובה שרוצים לעדכן.
  • ‫content (מחרוזת, חובה): התוכן המעודכן של הפוסט עם התגובה.
• ‫deleteComment: מחיקת שרשור תגובות. סכימה:
  • ‫commentId (מחרוזת, חובה): המזהה של שרשור התגובות שרוצים למחוק.
• ‫deleteCommentReply: מחיקת פוסט של תגובה. סכימה:
  • ‫commentId (מחרוזת, חובה): המזהה של שרשור התגובות.
  • ‫postId (מחרוזת, חובה): המזהה של הפוסט עם התגובה שרוצים למחוק.