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