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

פרמטרים

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

חזרה

‫Presentation — Presentation הזה, לשרשור.

אישור

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

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

addEditor(user)

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

פרמטרים

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

חזרה

‫Presentation — Presentation הזה, לשרשור.

אישור

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

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

addEditors(emailAddresses)

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

פרמטרים

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

חזרה

‫Presentation — Presentation הזה, לשרשור.

אישור

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

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

addViewer(emailAddress)

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

פרמטרים

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

חזרה

‫Presentation — Presentation הזה, לשרשור.

אישור

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

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

addViewer(user)

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

פרמטרים

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

חזרה

‫Presentation — Presentation הזה, לשרשור.

אישור

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

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

addViewers(emailAddresses)

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

פרמטרים

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

חזרה

‫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)

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

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

פרמטרים

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

חזרה

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

אישור

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

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

appendSlide(predefinedLayout)

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

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

פרמטרים

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

חזרה

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);

פרמטרים

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

חזרה

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,
);

פרמטרים

שםסוגתיאור
slideSlideהשקף שרוצים להעתיק, לצרף ולקשר.
linkingModeSlideLinkingModeמצב הקישור שבו רוצים להשתמש.

חזרה

‫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 אם לא קיים כזה.

פרמטרים

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

חזרה

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

אישור

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

  • 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 – ייצוג של הבחירה של המשתמש, או null אם הסקריפט לא מקושר למצגת או אם אין בחירה תקפה של המשתמש.

אישור

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

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

getSlideById(id)

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

פרמטרים

שםסוגתיאור
idStringהמזהה של השקף שאותו מאחזרים.

חזרה

‫Slide|null – השקף עם המזהה שצוין.

אישור

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

  • 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 הוא אפס.
  • התבנית הראשית הראשונה במצגת, אם אין שקף.

פרמטרים

שםסוגתיאור
insertionIndexIntegerהאינדקס (מספר המיקום) שבו יתווסף השקף, כשהספירה מתחילה מ-0.

חזרה

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

אישור

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

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

insertSlide(insertionIndex, layout)

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

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

פרמטרים

שםסוגתיאור
insertionIndexIntegerהאינדקס (מספר המיקום) שבו יתווסף השקף, כשהספירה מתחילה מ-0.
layoutLayoutהפריסה שבה רוצים להשתמש בשקף החדש. הפריסה צריכה להיות קיימת בשקף הראשי הנוכחי.

חזרה

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

אישור

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

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

insertSlide(insertionIndex, predefinedLayout)

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

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

פרמטרים

שםסוגתיאור
insertionIndexIntegerהאינדקס (מספר המיקום) שבו יתווסף השקף, כשהספירה מתחילה מ-0.
predefinedLayoutPredefinedLayoutהפריסה המוגדרת מראש שבה רוצים להשתמש בשקף החדש. הפריסה צריכה להיות קיימת בתבנית העיצוב הנוכחית.

חזרה

‫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);

פרמטרים

שםסוגתיאור
insertionIndexIntegerהאינדקס (מספר המיקום) שבו יתווסף השקף, כשהספירה מתחילה מ-0.
slideSlideהשקף שרוצים להעתיק ולהוסיף.

חזרה

‫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,
);

פרמטרים

שםסוגתיאור
insertionIndexIntegerהאינדקס (מספר המיקום) שבו יתווסף השקף, כשהספירה מתחילה מ-0.
slideSlideהשקף שרוצים להעתיק ולהוסיף.
linkingModeSlideLinkingModeמצב הקישור שבו רוצים להשתמש.

חזרה

‫Slide — השקף החדש.

אישור

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

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

removeEditor(emailAddress)

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

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

פרמטרים

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

חזרה

‫Presentation — Presentation הזה, לשרשור.

אישור

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

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

removeEditor(user)

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

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

פרמטרים

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

חזרה

‫Presentation — Presentation הזה, לשרשור.

אישור

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

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

removeViewer(emailAddress)

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

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

פרמטרים

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

חזרה

‫Presentation — This Presentation for chaining.

אישור

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

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

removeViewer(user)

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

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

פרמטרים

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

חזרה

‫Presentation — This Presentation for chaining.

אישור

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

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

replaceAllText(findText, replaceText)

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

פרמטרים

שםסוגתיאור
findTextStringהטקסט לחיפוש.
replaceTextStringהטקסט שיחליף את הטקסט התואם.

חזרה

‫Integer — מספר המופעים השתנה.

אישור

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

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

replaceAllText(findText, replaceText, matchCase)

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

פרמטרים

שםסוגתיאור
findTextStringהטקסט לחיפוש.
replaceTextStringהטקסט שיחליף את הטקסט התואם.
matchCaseBooleanאם הערך הוא 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)

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

פרמטרים

שםסוגתיאור
nameStringהשם שיוגדר למצגת הזו.

אישור

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

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