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

חזרה

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

פרמטרים

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

חזרה

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

אישור

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

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

getSlideById(id)

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

פרמטרים

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

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

חזרה

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

אישור

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

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

insertSlide(insertionIndex, layout)

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

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

פרמטרים

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

חזרה

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

אישור

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

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

insertSlide(insertionIndex, predefinedLayout)

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

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

פרמטרים

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

חזרה

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