Class Presentation

מצגה

מצגת.

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
addEditor(emailAddress)	Presentation	הוספת המשתמש הנתון לרשימת העורכים של Presentation.
addEditor(user)	Presentation	הוספת המשתמש הנתון לרשימת העורכים של Presentation.
addEditors(emailAddresses)	Presentation	הוספת מערך המשתמשים הנתון לרשימת העורכים של Presentation.
addViewer(emailAddress)	Presentation	הוספת המשתמש הנתון לרשימת הצופים ב-Presentation.
addViewer(user)	Presentation	הוספת המשתמש הנתון לרשימת הצופים ב-Presentation.
addViewers(emailAddresses)	Presentation	הפונקציה מוסיפה את מערך המשתמשים הנתון לרשימת הצופים ב-Presentation.
appendSlide()	Slide	הוספת שקף לסוף המצגת באמצעות הפריסה PredefinedLayout.BLANK שמוגדרת מראש על סמך גרסת המאסטר הנוכחית.
appendSlide(layout)	Slide	הוספת שקף לסוף המצגת באמצעות הפריסה שצוינה, על סמך הגרסה הראשית הנוכחית.
appendSlide(predefinedLayout)	Slide	הוספת שקף לסוף המצגת באמצעות הפריסה המוגדרת מראש על סמך גיליון המאסטר הנוכחי.
appendSlide(slide)	Slide	הוספת עותק של Slide שסופק בסוף המצגת.
appendSlide(slide, linkingMode)	Slide	הוספת עותק של Slide שסופק ממצגת המקור לסוף המצגת הנוכחית, והגדרת הקישור לשקף כפי שצוין ב-SlideLinkingMode.
getEditors()	User[]	הפונקציה מקבלת את רשימת העורכים של Presentation הזה.
getId()	String	הפונקציה מקבלת את המזהה הייחודי של המצגת.
getLayouts()	Layout[]	הפונקציה מקבלת את הפריסות במצגת.
getMasters()	Master[]	הפונקציה מקבלת את הגרסאות הראשיות (masters) במצגת.
getName()	String	הפונקציה מקבלת את השם או את הכותרת של המצגת.
getNotesMaster()	NotesMaster	הפונקציה מקבלת את קובץ המאסטר של ההערות במצגת.
getNotesPageHeight()	Number	הפונקציה מקבלת את גובה הדף של גיליון הערות הראשי ודפי הערות במצגת בנקודות.
getNotesPageWidth()	Number	הפונקציה מקבלת את רוחב הדף של דף הערות המאסטר ודפי ההערות במצגת בנקודות.
getPageElementById(id)	PageElement	הפונקציה מחזירה את ה-PageElement עם המזהה הנתון, או את הערך null אם לא קיים PageElement כזה.
getPageHeight()	Number	הפונקציה מקבלת את גובה הדף של השקופיות, הפריסות והתבניות הראשיות במצגת בנקודות.
getPageWidth()	Number	הפונקציה מקבלת את רוחב הדף של השקפים, הפריסות והתבניות הראשיות במצגת בנקודות.
getSelection()	Selection	הפונקציה מקבלת את הבחירה של המשתמש במצגת הפעילה.
getSlideById(id)	Slide	הפונקציה מחזירה את ה-Slide עם המזהה הנתון, או את הערך null אם לא קיים Slide כזה.
getSlides()	Slide[]	הפונקציה מקבלת את השקפים במצגת.
getUrl()	String	אחזור כתובת ה-URL לגישה למצגת הזו.
getViewers()	User[]	הפונקציה מקבלת את רשימת הצופים והמגיבים ב-Presentation הזה.
insertSlide(insertionIndex)	Slide	הוספת שקף באינדקס שצוין במצגת באמצעות הפריסה PredefinedLayout.BLANK שהוגדרה מראש על סמך הפריט הראשי הנוכחי.
insertSlide(insertionIndex, layout)	Slide	הוספת שקף באינדקס שצוין במצגת באמצעות הפריסה שצוינה, על סמך 'הפריט הראשי' הנוכחי.
insertSlide(insertionIndex, predefinedLayout)	Slide	הוספת שקף באינדקס שצוין במצגת באמצעות הפריסה המוגדרת מראש על סמך 'הפריט הראשי' הנוכחי.
insertSlide(insertionIndex, slide)	Slide	הוספת עותק של Slide שסופק במקום הנדרש במצגת.
insertSlide(insertionIndex, slide, linkingMode)	Slide	הוספת עותק של Slide שסופק מתוך מצגת המקור לאינדקס שצוין במצגת הנוכחית, והגדרת הקישור לשקף כפי שצוין ב-SlideLinkingMode.
removeEditor(emailAddress)	Presentation	הסרת המשתמש הנתון מרשימת העורכים של Presentation.
removeEditor(user)	Presentation	הסרת המשתמש הנתון מרשימת העורכים של Presentation.
removeViewer(emailAddress)	Presentation	הסרת המשתמש מהרשימה של הצופים והמגיבים ב-Presentation.
removeViewer(user)	Presentation	הסרת המשתמש מהרשימה של הצופים והמגיבים ב-Presentation.
replaceAllText(findText, replaceText)	Integer	הפונקציה מחליפה את כל המופעים של טקסט שתואמים לטקסט החיפוש בטקסט החלופי.
replaceAllText(findText, replaceText, matchCase)	Integer	הפונקציה מחליפה את כל המופעים של טקסט שתואמים לטקסט החיפוש בטקסט החלופי.
saveAndClose()	void	שמירת Presentation הנוכחי.
setName(name)	void	מגדיר את השם או הכותרת של המצגת.

מסמכים מפורטים

addEditor(emailAddress)

הוספת המשתמש הנתון לרשימת העורכים של Presentation. אם המשתמש כבר היה ברשימת הצופים, השיטה הזו תגרום להסרת המשתמש מרשימת הצופים.

פרמטרים

שם	סוג	תיאור
emailAddress	String	כתובת האימייל של המשתמש שרוצים להוסיף.

חזרה

Presentation — השדה Presentation, לצורך קישור.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

addEditor(user)

הוספת המשתמש הנתון לרשימת העורכים של Presentation. אם המשתמש כבר היה ברשימת הצופים, השיטה הזו תגרום להסרת המשתמש מרשימת הצופים.

פרמטרים

שם	סוג	תיאור
user	User	ייצוג של המשתמש שרוצים להוסיף.

חזרה

Presentation — השדה Presentation, לצורך קישור.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

addEditors(emailAddresses)

הוספת מערך המשתמשים הנתון לרשימת העורכים של Presentation. אם אחד מהמשתמשים כבר נכלל ברשימת הצופים, השיטה הזו תגרום להסרת המשתמש מרשימת הצופים.

פרמטרים

שם	סוג	תיאור
emailAddresses	String[]	מערך של כתובות האימייל של המשתמשים שרוצים להוסיף.

חזרה

Presentation — השדה Presentation, לצורך קישור.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

addViewer(emailAddress)

הוספת המשתמש הנתון לרשימת הצופים ב-Presentation. אם המשתמש כבר נכלל ברשימת העורכים, לשיטה הזו אין השפעה.

פרמטרים

שם	סוג	תיאור
emailAddress	String	כתובת האימייל של המשתמש שרוצים להוסיף.

חזרה

Presentation — השדה Presentation, לצורך קישור.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

addViewer(user)

הוספת המשתמש הנתון לרשימת הצופים ב-Presentation. אם המשתמש כבר נכלל ברשימת העורכים, לשיטה הזו אין השפעה.

פרמטרים

שם	סוג	תיאור
user	User	ייצוג של המשתמש שרוצים להוסיף.

חזרה

Presentation — השדה Presentation, לצורך קישור.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

addViewers(emailAddresses)

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

פרמטרים

שם	סוג	תיאור
emailAddresses	String[]	מערך של כתובות האימייל של המשתמשים שרוצים להוסיף.

חזרה

Presentation — השדה Presentation, לצורך קישור.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

appendSlide()

הוספת שקף לסוף המצגת באמצעות הפריסה PredefinedLayout.BLANK שמוגדרת מראש על סמך גרסת המאסטר הנוכחית. המאסטר הנוכחי הוא אחד מהאפשרויות הבאות:

• הגרסה הראשית של השקף האחרון הנוכחי.
• גיליון המאסטר הראשון במצגת, אם אין שקף.

חזרה

Slide – השקף החדש שמצורף.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

appendSlide(layout)

הוספת שקף לסוף המצגת באמצעות הפריסה שצוינה, על סמך הגרסה הראשית הנוכחית. המאסטר הנוכחי הוא אחד מהאפשרויות הבאות:

• הגרסה הראשית של השקף האחרון הנוכחי.
• גיליון המאסטר הראשון במצגת, אם אין שקף.

פרמטרים

שם	סוג	תיאור
layout	Layout	הפריסה שבה רוצים להשתמש בשקף החדש. היא צריכה להופיע בגרסה הראשית הנוכחית.

חזרה

Slide – השקף החדש שמצורף.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

appendSlide(predefinedLayout)

הוספת שקף לסוף המצגת באמצעות הפריסה המוגדרת מראש על סמך גיליון המאסטר הנוכחי. המאסטר הנוכחי הוא אחד מהאפשרויות הבאות:

• הגרסה הראשית של השקף האחרון הנוכחי.
• גיליון המאסטר הראשון במצגת, אם אין שקף.

פרמטרים

שם	סוג	תיאור
predefinedLayout	PredefinedLayout	הפריסה המוגדרת מראש שתשמש את השקף החדש. היא צריכה להופיע ב-master הנוכחי.

חזרה

Slide – השקף החדש שמצורף.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

appendSlide(slide)

הוספת עותק של Slide שסופק בסוף המצגת.

אם השקף שמעתיקים הוא ממצגת אחרת, גם דפי התצוגה הראשית והפריסה של ההורה יועתקו, אם הם עדיין לא קיימים במצגת הזו.

// Copy a slide from another presentation and appends it.
const otherPresentation = SlidesApp.openById('presentationId');
const currentPresentation = SlidesApp.getActivePresentation();
const slide = otherPresentation.getSlides()[0];
currentPresentation.appendSlide(slide);

פרמטרים

שם	סוג	תיאור
slide	Slide	השקופית שרוצים להעתיק ולהוסיף.

חזרה

Slide – השקף החדש שמצורף.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

appendSlide(slide, linkingMode)

הוספת עותק של Slide שסופק ממצגת המקור לסוף המצגת הנוכחית, והגדרת הקישור לשקף כפי שצוין ב-SlideLinkingMode.

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

אם מצב הקישור הוא SlideLinkingMode.LINKED, אפשר לעדכן את השקף המצורף כך שיתאים לשקף המקור שסופק כשקוראים ל-Slide.refreshSlide(). שותפי עריכה אחרים יכולים לראות את הקישור לשקף המקור. אי אפשר להשתמש ב-SlideLinkingMode.LINKED עם שקופיות מקור מהמצגת הנוכחית.

// Copy a slide from another presentation, then append and link it.
const sourcePresentation = SlidesApp.openById('presentationId');
const currentPresentation = SlidesApp.getActivePresentation();
const slide = sourcePresentation.getSlides()[0];
const appendedSlide = currentPresentation.appendSlide(
    slide,
    SlidesApp.SlideLinkingMode.LINKED,
);

פרמטרים

שם	סוג	תיאור
slide	Slide	השקופית שרוצים להעתיק, לצרף ולקשר.
linkingMode	SlideLinkingMode	מצב הקישור שבו רוצים להשתמש.

חזרה

Slide — השקף החדש.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

getEditors()

הפונקציה מקבלת את רשימת העורכים של Presentation הזה.

חזרה

User[] – מערך של משתמשים עם הרשאת עריכה.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

getId()

הפונקציה מקבלת את המזהה הייחודי של המצגת. מזהה המצגת משמש עם SlidesApp.openById() כדי לפתוח מופע ספציפי של מצגת.

חזרה

String — המזהה של המצגת הזו.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

getLayouts()

הפונקציה מקבלת את הפריסות במצגת.

חזרה

Layout[] – רשימת הפריסות במצגת הזו.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

getMasters()

הפונקציה מקבלת את הגרסאות הראשיות (masters) במצגת.

חזרה

Master[] – רשימת קובצי המאסטר במצגת הזו.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

getName()

הפונקציה מקבלת את השם או את הכותרת של המצגת.

חזרה

String — שם המצגת.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

getNotesMaster()

הפונקציה מקבלת את קובץ המאסטר של ההערות במצגת.

חזרה

NotesMaster – קובץ ההערות הראשי של המצגת.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

getNotesPageHeight()

הפונקציה מקבלת את גובה הדף של גיליון הערות הראשי ודפי הערות במצגת בנקודות. לכל הדפים יש גובה זהה.

חזרה

Number — גובה דף ההערות בנקודות.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

getNotesPageWidth()

הפונקציה מקבלת את רוחב הדף של דף הערות המאסטר ודפי ההערות במצגת בנקודות. לכל הדפים יש אותה רוחב דף.

חזרה

Number — רוחב דף ההערות בנקודות.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

getPageElementById(id)

הפונקציה מחזירה את ה-PageElement עם המזהה הנתון, או את הערך null אם לא קיים PageElement כזה.

פרמטרים

שם	סוג	תיאור
id	String	המזהה של רכיב הדף שאוחזר.

חזרה

PageElement – רכיב הדף עם המזהה הנתון.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

getPageHeight()

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

חזרה

Number — גובה הדף בנקודות.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

getPageWidth()

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

חזרה

Number – רוחב הדף בנקודות.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

getSelection()

הפונקציה מקבלת את הבחירה של המשתמש במצגת הפעילה. סקריפט יכול לגשת רק לבחירה של המשתמש שמפעיל אותו, ורק אם הסקריפט קשור למצגת.

שימו לב שהבחירה שמוחזרת היא הבחירה היעילה הנוכחית. כשהסקריפט מבצע שינויים שונים במצגת, הבחירה עוברת טרנספורמציה כדי להביא בחשבון את השינויים האלה. לדוגמה, אם בוחרים שתי צורות, A ו-B, ואז הסקריפט מסיר את הצורה B, אובייקט הבחירה המוחזר מתעדכן באופן משתמע כך שרק הצורה A תהיה מסומנת.

// Gets the current active page that is selected in the active presentation.
const selection = SlidesApp.getActivePresentation().getSelection();
const currentPage = selection.getCurrentPage();

חזרה

Selection – ייצוג של הבחירה של המשתמש, או null אם הסקריפט לא מקושר למצגת או אם אין בחירה תקינה של המשתמש.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

getSlideById(id)

הפונקציה מחזירה את ה-Slide עם המזהה הנתון, או את הערך null אם לא קיים Slide כזה.

פרמטרים

שם	סוג	תיאור
id	String	המזהה של השקופית שאוחזרה.

חזרה

Slide – השקופית עם המזהה שצוין.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

getSlides()

הפונקציה מקבלת את השקפים במצגת.

חזרה

Slide[] — רשימת השקפים במצגת הזו.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

getUrl()

אחזור כתובת ה-URL לגישה למצגת הזו.

const presentation = SlidesApp.getActivePresentation();

// Send out the link to open the presentation.
MailApp.sendEmail(
    '<email-address>',
    presentation.getName(),
    presentation.getUrl(),
);

חזרה

String – כתובת ה-URL לגישה למצגת הנוכחית.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

getViewers()

הפונקציה מקבלת את רשימת הצופים והמגיבים ב-Presentation הזה.

חזרה

User[] – מערך של משתמשים עם הרשאת צפייה או הרשאת תגובה.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

insertSlide(insertionIndex)

הוספת שקף באינדקס שצוין במצגת באמצעות הפריסה PredefinedLayout.BLANK שהוגדרה מראש על סמך הפריט הראשי הנוכחי. המאסטר הנוכחי הוא אחד מהפריטים הבאים:

• גיליון האם של השקף הקודם.
• גיליון האם של השקופית הראשונה, אם הערך של insertionIndex הוא אפס.
• גיליון המאסטר הראשון במצגת, אם אין שקף.

פרמטרים

שם	סוג	תיאור
insertionIndex	Integer	האינדקס שמתחיל באפס ומציין את המיקום שבו רוצים להוסיף את השקף.

חזרה

Slide — השקף החדש שנוסף.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

insertSlide(insertionIndex, layout)

הוספת שקף באינדקס שצוין במצגת באמצעות הפריסה שצוינה, על סמך 'הפריט הראשי' הנוכחי. המאסטר הנוכחי הוא אחד מהאפשרויות הבאות:

• גיליון האם של השקף הקודם.
• גיליון האם של השקופית הראשונה, אם הערך של insertionIndex הוא אפס.
• גיליון המאסטר הראשון במצגת, אם אין שקף.

פרמטרים

שם	סוג	תיאור
insertionIndex	Integer	האינדקס שמתחיל באפס ומציין את המיקום שבו רוצים להוסיף את השקף.
layout	Layout	הפריסה שבה רוצים להשתמש בשקף החדש. היא צריכה להופיע בגרסה הראשית הנוכחית.

חזרה

Slide — השקף החדש שנוסף.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

insertSlide(insertionIndex, predefinedLayout)

הוספת שקף באינדקס שצוין במצגת באמצעות הפריסה המוגדרת מראש על סמך 'הפריט הראשי' הנוכחי. המאסטר הנוכחי הוא אחד מהאפשרויות הבאות:

• גיליון האם של השקף הקודם.
• גיליון האם של השקופית הראשונה, אם הערך של insertionIndex הוא אפס.
• גיליון המאסטר הראשון במצגת, אם אין שקף.

פרמטרים

שם	סוג	תיאור
insertionIndex	Integer	האינדקס שמתחיל באפס ומציין את המיקום שבו רוצים להוסיף את השקף.
predefinedLayout	PredefinedLayout	הפריסה המוגדרת מראש שתשמש את השקף החדש. היא צריכה להופיע ב-master הנוכחי.

חזרה

Slide — השקף החדש שנוסף.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

insertSlide(insertionIndex, slide)

הוספת עותק של Slide שסופק במקום הנדרש במצגת.

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

// Copy a slide from another presentation and inserts it.
const otherPresentation = SlidesApp.openById('presentationId');
const currentPresentation = SlidesApp.getActivePresentation();
const slide = otherPresentation.getSlides()[0];
const insertionIndex = 1;
currentPresentation.insertSlide(insertionIndex, slide);

פרמטרים

שם	סוג	תיאור
insertionIndex	Integer	האינדקס שמתחיל באפס ומציין את המיקום שבו רוצים להוסיף את השקף.
slide	Slide	השקף שרוצים להעתיק ולהוסיף.

חזרה

Slide — השקף החדש שנוסף.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

insertSlide(insertionIndex, slide, linkingMode)

הוספת עותק של Slide שסופק מתוך מצגת המקור לאינדקס שצוין במצגת הנוכחית, והגדרת הקישור לשקף כפי שצוין ב-SlideLinkingMode.

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

אם מצב הקישור הוא SlideLinkingMode.LINKED, אפשר לעדכן את השקף שהוכנס כך שיתאים לשקף המקור שסופק כשמפעילים את Slide.refreshSlide(). שותפי עריכה אחרים יכולים לראות את הקישור לשקף המקור. אי אפשר להשתמש ב-SlideLinkingMode.LINKED עם שקופיות מקור מהמצגת הנוכחית.

// Copy a slide from another presentation, then insert and link it.
const sourcePresentation = SlidesApp.openById('presentationId');
const currentPresentation = SlidesApp.getActivePresentation();
const slide = sourcePresentation.getSlides()[0];
const insertionIndex = 1;
const insertedSlide = currentPresentation.insertSlide(
    insertionIndex,
    slide,
    SlidesApp.SlideLinkingMode.LINKED,
);

פרמטרים

שם	סוג	תיאור
insertionIndex	Integer	האינדקס שמתחיל באפס ומציין את המיקום שבו רוצים להוסיף את השקף.
slide	Slide	השקף שרוצים להעתיק ולהוסיף.
linkingMode	SlideLinkingMode	מצב הקישור שבו רוצים להשתמש.

חזרה

Slide — השקף החדש.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

removeEditor(emailAddress)

הסרת המשתמש הנתון מרשימת העורכים של Presentation. השיטה הזו לא מונעת ממשתמשים לגשת ל-Presentation אם הם שייכים לקבוצת משתמשים שיש להם גישה כללית – לדוגמה, אם ה-Presentation משותף עם כל הדומיין של המשתמש, או אם ה-Presentation נמצא באחסון שיתופי שהמשתמש יכול לגשת אליו.

בקבצים ב-Drive, הפעולה הזו מסירה את המשתמש גם מרשימת הצופים.

פרמטרים

שם	סוג	תיאור
emailAddress	String	כתובת האימייל של המשתמש שרוצים להסיר.

חזרה

Presentation — השדה Presentation, לצורך קישור.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

removeEditor(user)

הסרת המשתמש הנתון מרשימת העורכים של Presentation. השיטה הזו לא מונעת ממשתמשים לגשת ל-Presentation אם הם שייכים לקבוצת משתמשים שיש להם גישה כללית – לדוגמה, אם ה-Presentation משותף עם כל הדומיין של המשתמש, או אם ה-Presentation נמצא באחסון שיתופי שהמשתמש יכול לגשת אליו.

בקבצים ב-Drive, הפעולה הזו מסירה את המשתמש גם מרשימת הצופים.

פרמטרים

שם	סוג	תיאור
user	User	ייצוג של המשתמש שרוצים להסיר.

חזרה

Presentation — השדה Presentation, לצורך קישור.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

removeViewer(emailAddress)

הסרת המשתמש מהרשימה של הצופים והמגיבים ב-Presentation. השיטה הזו לא משפיעה אם המשתמש הוא עורך, ולא צופה או מגיב. בנוסף, השיטה הזו לא מונעת ממשתמשים לגשת ל-Presentation אם הם שייכים לקבוצת משתמשים שיש להם גישה כללית – לדוגמה, אם ה-Presentation משותף עם כל הדומיין של המשתמש, או אם ה-Presentation נמצא בתיקיית אחסון שיתופי שהמשתמש יכול לגשת אליה.

בקבצים ב-Drive, הפעולה הזו תסיר גם את המשתמש מרשימת העריכה.

פרמטרים

שם	סוג	תיאור
emailAddress	String	כתובת האימייל של המשתמש שרוצים להסיר.

חזרה

Presentation — Presentation לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

removeViewer(user)

הסרת המשתמש מהרשימה של הצופים והמגיבים ב-Presentation. השיטה הזו לא משפיעה אם המשתמש הוא עורך ולא צופה. השיטה הזו גם לא מונעת ממשתמשים לגשת ל-Presentation אם הם שייכים לקבוצת משתמשים שיש להם גישה כללית – לדוגמה, אם ה-Presentation משותף עם כל הדומיין של המשתמש, או אם ה-Presentation נמצא באחסון שיתופי שהמשתמש יכול לגשת אליו.

בקבצים ב-Drive, הפעולה הזו תסיר גם את המשתמש מרשימת העריכה.

פרמטרים

שם	סוג	תיאור
user	User	ייצוג של המשתמש שרוצים להסיר.

חזרה

Presentation — Presentation לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

replaceAllText(findText, replaceText)

הפונקציה מחליפה את כל המופעים של טקסט שתואמים לטקסט החיפוש בטקסט החלופי. החיפוש לא תלוי אותיות רישיות.

פרמטרים

שם	סוג	תיאור
findText	String	הטקסט שרוצים למצוא.
replaceText	String	הטקסט שרוצים להחליף את הטקסט התואם.

חזרה

Integer – מספר החזרות השתנה

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

replaceAllText(findText, replaceText, matchCase)

הפונקציה מחליפה את כל המופעים של טקסט שתואמים לטקסט החיפוש בטקסט החלופי.

פרמטרים

שם	סוג	תיאור
findText	String	הטקסט שרוצים למצוא.
replaceText	String	הטקסט שרוצים להחליף את הטקסט התואם.
matchCase	Boolean	אם הערך הוא true, החיפוש תלוי אותיות רישיות. אם הערך הוא false, החיפוש לא תלוי אותיות רישיות.

חזרה

Integer – מספר החזרות השתנה

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

saveAndClose()

שמירת Presentation הנוכחי. הפקודה גורמת לכך שעדכונים בהמתנה יימחקו ויחולו.

השיטה saveAndClose() מופעלת באופן אוטומטי בסוף ההרצה של הסקריפט לכל Presentation פתוח, גם אם ההרצה של הסקריפט הסתיימה עם שגיאה.

לא ניתן לערוך Presentation סגור. משתמשים באחת מהשיטות לפתיחה ב-SlidesApp כדי לפתוח מחדש מצגת מסוימת לעריכה.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

setName(name)

מגדיר את השם או הכותרת של המצגת.

פרמטרים

שם	סוג	תיאור
name	String	השם שרוצים להגדיר למצגת.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations