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. אם המשתמש כבר היה ברשימת הצופים, השיטה הזו מקדמת את המשתמש מחוץ לרשימת הצופים.

פרמטרים

שםתיאורהתיאור
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.
var otherPresentation = SlidesApp.openById('presentationId');
var currentPresentation = SlidesApp.getActivePresentation();
var 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.
var sourcePresentation = SlidesApp.openById('presentationId');
var currentPresentation = SlidesApp.getActivePresentation();
var slide = sourcePresentation.getSlides()[0];
var 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 - רכיב הדף עם המזהה הנתון.

הרשאות

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

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

פרמטרים

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

החזרות

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 על סמך המאסטר הנוכחי. המאסטר הנוכחי הוא אחד מהבאים:

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

פרמטרים

שםתיאורהתיאור
insertionIndexIntegerאינדקס מבוסס-אפס שמציין איפה צריך להוסיף את השקף.

החזרות

Slide - השקף החדש שיוכנס.

הרשאות

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

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

insertSlide(insertionIndex, layout)

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

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

פרמטרים

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

החזרות

Slide - השקף החדש שיוכנס.

הרשאות

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

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

insertSlide(insertionIndex, predefinedLayout)

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

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

פרמטרים

שםתיאורהתיאור
insertionIndexIntegerאינדקס מבוסס-אפס שמציין איפה צריך להוסיף את השקף.
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.
var otherPresentation = SlidesApp.openById('presentationId');
var currentPresentation = SlidesApp.getActivePresentation();
var slide = otherPresentation.getSlides()[0];
var insertionIndex = 1;
currentPresentation.insertSlide(insertionIndex, slide);

פרמטרים

שםתיאורהתיאור
insertionIndexIntegerאינדקס מבוסס-אפס שמציין איפה צריך להוסיף את השקף.
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.
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);

פרמטרים

שםתיאורהתיאור
insertionIndexIntegerאינדקס מבוסס-אפס שמציין איפה צריך להוסיף את השקף.
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 – Presentation לשרשור.

הרשאות

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

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

removeViewer(user)

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

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

פרמטרים

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

החזרות

Presentation – Presentation לשרשור.

הרשאות

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

  • 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