דף זה תורגם על ידי Cloud Translation API.

Class Presentation

מצגת.

שיטות

שיטה	סוג הערך המוחזר	תיאור קצר
`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[]`	קבלת המאסטרים במצגת.
`getName()`	`String`	קבלת השם או הכותרת של המצגת.
`getNotesMaster()`	`NotesMaster`	מקבל את מאסטר ההערות של המצגת.
`getNotesPageHeight()`	`Number`	הפונקציה מקבלת את גובה הדף של מאסטר ההערות ודפי ההערות במצגת בנקודות.
`getNotesPageWidth()`	`Number`	מקבל את רוחב הדף של המאסטר של ההערות ודפי ההערות במצגת.
`getPageElementById(id)`	`PageElement`	הפונקציה מחזירה את `PageElement` עם המזהה הנתון, או את `null` אם לא קיים.
`getPageHeight()`	`Number`	מקבל בנקודות את גובה הדף של השקפים, הפריסות והמאסטרים במצגת.
`getPageWidth()`	`Number`	מקבל את רוחב העמוד של השקפים, הפריסות והמאסטרים במצגת בנקודות.
`getSelection()`	`Selection`	מקבל את הבחירה של המשתמש במצגת הפעילה.
`getSlideById(id)`	`Slide`	הפונקציה מחזירה את `Slide` עם המזהה הנתון, או את `null` אם לא קיים.
`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)`

פרמטרים

שם	סוג	תיאור
`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`	הפריסה המוגדרת מראש לשימוש בשקף החדש. הוא אמור להופיע במאסטר הנוכחי.

חזרה

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.
var otherPresentation = SlidesApp.openById('presentationId');
var currentPresentation = SlidesApp.getActivePresentation();
var 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.
var sourcePresentation = SlidesApp.openById('presentationId');
var currentPresentation = SlidesApp.getActivePresentation();
var slide = sourcePresentation.getSlides()[0];
var 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()`

קבלת המאסטרים במצגת.

חזרה

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 אם לא קיים.

פרמטרים

שם	סוג	תיאור
`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.
var selection = SlidesApp.getActivePresentation().getSelection();
var currentPage = selection.getCurrentPage();

חזרה

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

אישור

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

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

`getSlideById(id)`

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

פרמטרים

שם	סוג	תיאור
`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 כדי לגשת למצגת הזו.

var 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`	`Integer`	האינדקס מבוסס על אפס, שמציין איפה להוסיף את השקף.

חזרה

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

אישור

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

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

`insertSlide(insertionIndex, layout)`

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

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

פרמטרים

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

חזרה

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

אישור

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

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

`insertSlide(insertionIndex, predefinedLayout)`

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

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

פרמטרים

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

חזרה

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.
var otherPresentation = SlidesApp.openById('presentationId');
var currentPresentation = SlidesApp.getActivePresentation();
var slide = otherPresentation.getSlides()[0];
var 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.
var sourcePresentation = SlidesApp.openById('presentationId');
var currentPresentation = SlidesApp.getActivePresentation();
var slide = sourcePresentation.getSlides()[0];
var insertionIndex = 1;
var 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)`

בקובצי Drive, המשתמש יוסר גם מרשימת הצופים.

פרמטרים

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

חזרה

Presentation – Presentation, לשרשור.

אישור

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

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

`removeViewer(emailAddress)`

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

בקובצי Drive, המשתמש יוסר גם מרשימת העורכים.

פרמטרים

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

חזרה

Presentation – ה-Presentation הזה לשרשור.

אישור

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

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

`removeViewer(user)`

הסרה של המשתמש הנתון מרשימת הצופים והמגיבים של Presentation. הזה ל-method אין השפעה אם המשתמש הוא עורך ולא צופה. השיטה הזו גם לא חוסמת למשתמשים לגשת אל 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