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 נמצא באחסון שיתופי שהמשתמש יכול לגשת אליו.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