Class Slide

שקף

שקף במצגת.

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

שיטות

שיטהסוג הערך שמוחזרתיאור קצר
duplicate()Slideשכפול השקף.
getBackground()PageBackgroundהפונקציה מקבלת את הרקע של הדף.
getColorScheme()ColorSchemeהפונקציה מקבלת את ה-ColorScheme שמשויך לדף.
getGroups()Group[]מחזירה את הרשימה של Group אובייקטים בדף.
getImages()Image[]מחזירה את הרשימה של Image אובייקטים בדף.
getLayout()Layoutהפונקציה מקבלת את הפריסה שעליה מבוסס השקף, או את הפריסה null אם השקף לא מבוסס על פריסה.
getLines()Line[]מחזירה את הרשימה של Line אובייקטים בדף.
getNotesPage()NotesPageמחזירה את דף ההערות המשויך לשקף.
getObjectId()Stringהפונקציה מקבלת את המזהה הייחודי של הדף.
getPageElementById(id)PageElementמחזירה את PageElement בדף עם המזהה הנתון, או null אם לא קיים.
getPageElements()PageElement[]מחזירה את הרשימה של PageElement אובייקטים שעובדו בדף.
getPageType()PageTypeהפונקציה מקבלת את סוג הדף.
getPlaceholder(placeholderType)PageElementהפונקציה מחזירה את האובייקט PageElement של ה-placeholder עבור PlaceholderType או null שצוינו אם לא קיים placeholder תואם.
getPlaceholder(placeholderType, placeholderIndex)PageElementהפונקציה מחזירה את האובייקט PageElement של ה-placeholder עבור PlaceholderType שצוין ואינדקס של placeholder, או את הערך null אם ה-placeholder לא קיים.
getPlaceholders()PageElement[]מחזירה את רשימת האובייקטים של ה-placeholder PageElement בדף.
getShapes()Shape[]מחזירה את הרשימה של Shape אובייקטים בדף.
getSheetsCharts()SheetsChart[]מחזירה את הרשימה של SheetsChart אובייקטים בדף.
getSlideLinkingMode()SlideLinkingModeמחזירה SlideLinkingMode שמציין אם השקף מקושר לשקף אחר.
getSourcePresentationId()Stringהפונקציה מחזירה את המזהה Presentation של המקור או את הערך null אם השקף לא מקושר.
getSourceSlideObjectId()Stringמחזירה את מזהה השקף של המקור או את הערך null אם השקף לא מקושר.
getTables()Table[]מחזירה את הרשימה של Table אובייקטים בדף.
getVideos()Video[]מחזירה את הרשימה של Video אובייקטים בדף.
getWordArts()WordArt[]מחזירה את הרשימה של WordArt אובייקטים בדף.
group(pageElements)Groupקיבוץ כל רכיבי הדף שצוינו.
insertGroup(group)Groupהוספת עותק של Group שסופק בדף.
insertImage(blobSource)Imageהוספת תמונה בפינה השמאלית העליונה של הדף, עם גודל ברירת מחדל מה-blob של התמונה שצוין.
insertImage(blobSource, left, top, width, height)Imageהוספת תמונה לדף במיקום ובגודל שצוינו ב-blob התמונה שצוין.
insertImage(image)Imageהוספת עותק של Image שסופק בדף.
insertImage(imageUrl)Imageמוסיף תמונה בפינה הימנית העליונה של הדף בגודל ברירת מחדל מכתובת האתר שסופקה.
insertImage(imageUrl, left, top, width, height)Imageהוספת תמונה לדף עם המיקום והגודל שצוינו מכתובת ה-URL שצוינה.
insertLine(line)Lineהוספת עותק של Line שסופק בדף.
insertLine(lineCategory, startConnectionSite, endConnectionSite)Lineהוספת שורה בדף המחברת בין שני ערכי connection sites.
insertLine(lineCategory, startLeft, startTop, endLeft, endTop)Lineהוספת שורה לדף.
insertPageElement(pageElement)PageElementהוספת עותק של PageElement שסופק בדף.
insertShape(shape)Shapeהוספת עותק של Shape שסופק בדף.
insertShape(shapeType)Shapeהוספת צורה לדף.
insertShape(shapeType, left, top, width, height)Shapeהוספת צורה לדף.
insertSheetsChart(sourceChart)SheetsChartהוספת תרשים של Google Sheets לדף.
insertSheetsChart(sourceChart, left, top, width, height)SheetsChartהוספת תרשים של Google Sheets לדף עם המיקום והגודל שצוינו.
insertSheetsChart(sheetsChart)SheetsChartהוספת עותק של SheetsChart שסופק בדף.
insertSheetsChartAsImage(sourceChart)Imageהוספת תרשים של Google Sheets כ-Image בדף.
insertSheetsChartAsImage(sourceChart, left, top, width, height)Imageהוספת תרשים של Google Sheets בפורמט Image בדף, עם המיקום והגודל שצוינו.
insertTable(numRows, numColumns)Tableהוספת טבלה לדף.
insertTable(numRows, numColumns, left, top, width, height)Tableהוספת טבלה בדף עם המיקום והגודל שצוינו.
insertTable(table)Tableהוספת עותק של Table שסופק בדף.
insertTextBox(text)Shapeמוסיף תיבת טקסט Shape שמכילה את המחרוזת הנתונה בדף.
insertTextBox(text, left, top, width, height)Shapeמוסיף תיבת טקסט Shape שמכילה את המחרוזת הנתונה בדף.
insertVideo(videoUrl)Videoמוסיף סרטון בפינה הימנית העליונה של הדף עם גודל ברירת מחדל.
insertVideo(videoUrl, left, top, width, height)Videoהוספת סרטון לדף עם המיקום והגודל שסופקו.
insertVideo(video)Videoהוספת עותק של Video שסופק בדף.
insertWordArt(wordArt)WordArtהוספת עותק של WordArt שסופק בדף.
isSkipped()Booleanמחזירה את האפשרות לדלג על השקף במצב 'מצגת'.
move(index)voidמעבירים את השקף לאינדקס שצוין.
refreshSlide()voidרענון השקף כדי לשקף את השינויים שבוצעו בשקף המקור המקושר.
remove()voidהסרת הדף.
replaceAllText(findText, replaceText)Integerמחליף את כל המופעים של טקסט התואם את הטקסט ל'החלפה'.
replaceAllText(findText, replaceText, matchCase)Integerמחליף את כל המופעים של טקסט התואם את הטקסט ל'החלפה'.
selectAsCurrentPage()voidבוחר ב-Page במצגת הפעילה בתור current page selection ומסיר את כל הבחירה הקודמת.
setSkipped(isSkipped)voidהמדיניות הזו קובעת אם המערכת תדלג על השקף במצב 'מצגת'.
unlink()voidביטול הקישור של Slide הנוכחי משקף המקור שלו.

תיעוד מפורט

duplicate()

שכפול השקף.

השקף הכפול נוצר מיד אחרי השקף המקורי.

החזרות

Slide - השקף הכפול.

הרשאות

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

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

getBackground()

הפונקציה מקבלת את הרקע של הדף.

החזרות

PageBackground - הרקע של הדף.

הרשאות

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

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

getColorScheme()

הפונקציה מקבלת את ה-ColorScheme שמשויך לדף.

החזרות

ColorScheme - ערכת הצבעים של הדף.

הרשאות

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

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

getGroups()

מחזירה את הרשימה של Group אובייקטים בדף.

החזרות

Group[]

הרשאות

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

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

getImages()

מחזירה את הרשימה של Image אובייקטים בדף.

החזרות

Image[]

הרשאות

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

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

getLayout()

הפונקציה מקבלת את הפריסה שעליה מבוסס השקף, או את הפריסה null אם השקף לא מבוסס על פריסה.

החזרות

Layout

הרשאות

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

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

getLines()

מחזירה את הרשימה של Line אובייקטים בדף.

החזרות

Line[]

הרשאות

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

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

getNotesPage()

מחזירה את דף ההערות המשויך לשקף.

החזרות

NotesPage

הרשאות

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

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

getObjectId()

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

החזרות

String

הרשאות

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

  • 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

getPageElements()

מחזירה את הרשימה של PageElement אובייקטים שעובדו בדף.

החזרות

PageElement[]

הרשאות

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

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

getPageType()

הפונקציה מקבלת את סוג הדף.

החזרות

PageType - סוג הדף.

הרשאות

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

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

getPlaceholder(placeholderType)

הפונקציה מחזירה את האובייקט PageElement של ה-placeholder עבור PlaceholderType או null שצוינו אם לא קיים placeholder תואם.

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

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var placeholder = slide.getPlaceholder(SlidesApp.PlaceholderType.CENTERED_TITLE);

פרמטרים

שםתיאורהתיאור
placeholderTypePlaceholderType

החזרות

PageElement

הרשאות

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

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

getPlaceholder(placeholderType, placeholderIndex)

הפונקציה מחזירה את האובייקט PageElement של ה-placeholder עבור PlaceholderType שצוין ואינדקס של placeholder, או את הערך null אם ה-placeholder לא קיים.

אם יש מספר placeholders באותו סוג ובאותו אינדקס, הוא יחזיר את ה-placeholder הראשון מאוסף רכיבי הדף של הדף. 

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var placeholder = slide.getPlaceholder(SlidesApp.PlaceholderType.CENTERED_TITLE, 0);

פרמטרים

שםתיאורהתיאור
placeholderTypePlaceholderType
placeholderIndexInteger

החזרות

PageElement

הרשאות

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

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

getPlaceholders()

מחזירה את רשימת האובייקטים של ה-placeholder PageElement בדף. 

var master = SlidesApp.getActivePresentation().getMasters()[0];
Logger.log('Number of placeholders in the master: ' + master.getPlaceholders().length);

החזרות

PageElement[]

הרשאות

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

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

getShapes()

מחזירה את הרשימה של Shape אובייקטים בדף.

החזרות

Shape[]

הרשאות

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

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

getSheetsCharts()

מחזירה את הרשימה של SheetsChart אובייקטים בדף.

החזרות

SheetsChart[]

הרשאות

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

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

getSlideLinkingMode()

מחזירה SlideLinkingMode שמציין אם השקף מקושר לשקף אחר.

החזרות

SlideLinkingMode – המצב של קישור שקפים.

הרשאות

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

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

getSourcePresentationId()

הפונקציה מחזירה את המזהה Presentation של המקור או את הערך null אם השקף לא מקושר.

לשקף יש מזהה Presentation של מקור רק כשהוא מקושר לשקף בתוך מצגת אחרת.

החזרות

String – מזהה המצגת של המקור או null.

הרשאות

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

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

getSourceSlideObjectId()

מחזירה את מזהה השקף של המקור או את הערך null אם השקף לא מקושר.

שקף מכיל מזהה שקף של מקור רק אם הוא מקושר לשקף בתוך מצגת אחרת.

החזרות

String – מזהה השקף של המקור או null.

הרשאות

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

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

getTables()

מחזירה את הרשימה של Table אובייקטים בדף.

החזרות

Table[]

הרשאות

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

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

getVideos()

מחזירה את הרשימה של Video אובייקטים בדף.

החזרות

Video[]

הרשאות

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

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

getWordArts()

מחזירה את הרשימה של WordArt אובייקטים בדף.

החזרות

WordArt[]

הרשאות

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

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

group(pageElements)

קיבוץ כל רכיבי הדף שצוינו.

צריכים להיות לפחות שני אלמנטים בדף באותו דף שלא נמצאים עדיין בקבוצה אחרת. לא ניתן לקבץ חלק מרכיבי הדף כגון Videos, Tables ו-placeholder Shapes.

פרמטרים

שםתיאורהתיאור
pageElementsPageElement[]הרכיבים שיש לקבץ יחד.

החזרות

Group - הקבוצה החדשה.

הרשאות

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

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

insertGroup(group)

הוספת עותק של Group שסופק בדף.

מיקום הרכיב שנוסף בדף הזה נקבע לפי המיקום של רכיב המקור בדף שלו.

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

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

// Copy a group between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var group = otherPresentationSlide.getGroups()[0];
currentPresentationSlide.insertGroup(group); // Also available for Layout, Master, and Page.

פרמטרים

שםתיאורהתיאור
groupGroupהקבוצה להעתקה ולהוספה.

החזרות

Group - הקבוצה שהוכנסה.

הרשאות

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

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

insertImage(blobSource)

הוספת תמונה בפינה השמאלית העליונה של הדף, עם גודל ברירת מחדל מה-blob של התמונה שצוין.

הוספת התמונה תאחזר אותה מה-BlobSource פעם אחת, ועותק מאוחסן לצורך הצגה במצגת. התמונות צריכות להיות בפורמט של פחות מ-50MB, לא יותר מ-25 מגה-פיקסלים בפורמט PNG, JPEG או GIF. 

var slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
var image = DriveApp.getFileById(fileId);
slide.insertImage(image);

פרמטרים

שםתיאורהתיאור
blobSourceBlobSourceנתוני התמונה.

החזרות

Image – התמונה שהוכנסה.

הרשאות

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

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

insertImage(blobSource, left, top, width, height)

הוספת תמונה לדף במיקום ובגודל שצוינו ב-blob התמונה שצוין.

התמונה נשלפת מה-BlobSource שסופק פעם אחת בזמן ההוספה, ועותק מאוחסן במצגת. התמונות צריכות להיות בפורמט של פחות מ-50MB, לא לחרוג מ-25 מגה-פיקסלים בפורמט PNG, JPEG או GIF.

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

var slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
var image = DriveApp.getFileById(fileId);
var position = {left: 0, top: 0};
var size = {width: 300, height: 100};
slide.insertImage(image, position.left, position.top, size.width, size.height);

פרמטרים

שםתיאורהתיאור
blobSourceBlobSourceנתוני התמונה.
leftNumberהמיקום האופקי של התמונה בנקודות, במדידה מהפינה השמאלית העליונה של הדף.
topNumberהמיקום האנכי של התמונה בנקודות, במדידה מהפינה השמאלית העליונה של הדף.
widthNumberרוחב התמונה בנקודות.
heightNumberגובה התמונה בנקודות.

החזרות

Image – התמונה שהוכנסה.

הרשאות

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

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

insertImage(image)

הוספת עותק של Image שסופק בדף.

המיקום של התמונות שנוספו בדף הזה נקבע לפי המיקום של תמונת המקור בדף שלה.

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

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

// Copy an image between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var image = otherPresentationSlide.getImages[0];
currentPresentationSlide.insertImage(image);

פרמטרים

שםתיאורהתיאור
imageImageהתמונה להעתקה ולהוספה.

החזרות

Image – התמונה שהוכנסה.

הרשאות

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

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

insertImage(imageUrl)

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

כשמוסיפים את התמונה, היא מאחזרת אותה מכתובת ה-URL פעם אחת, ועותק נשמר להצגה במצגת. התמונות צריכות להיות בגודל של פחות מ-50MB, לא יותר מ-25 מגה-פיקסלים ולהיות בפורמט PNG, JPEG או GIF.

כתובת ה-URL שצוינה חייבת להיות נגישה לכולם ובגודל של עד 2KB. כתובת ה-URL עצמה נשמרת עם התמונה ונחשפת באמצעות Image.getSourceUrl().

פרמטרים

שםתיאורהתיאור
imageUrlStringכתובת ה-URL של התמונה.

החזרות

Image – התמונה שהוכנסה.

הרשאות

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

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

insertImage(imageUrl, left, top, width, height)

הוספת תמונה לדף עם המיקום והגודל שצוינו מכתובת ה-URL שצוינה.

כשמוסיפים את התמונה, היא מאחזרת אותה מכתובת ה-URL פעם אחת, ועותק נשמר להצגה במצגת. התמונות צריכות להיות בגודל של פחות מ-50MB, לא יותר מ-25 מגה-פיקסלים ולהיות בפורמט PNG, JPEG או GIF.

כתובת ה-URL שצוינה חייבת להיות נגישה לכולם ובגודל של עד 2KB. כתובת ה-URL עצמה נשמרת עם התמונה ונחשפת באמצעות Image.getSourceUrl().

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

פרמטרים

שםתיאורהתיאור
imageUrlStringכתובת ה-URL של התמונה.
leftNumberהמיקום האופקי של התמונה בנקודות, במדידה מהפינה השמאלית העליונה של הדף.
topNumberהמיקום האנכי של התמונה בנקודות, במדידה מהפינה השמאלית העליונה של הדף.
widthNumberרוחב התמונה בנקודות.
heightNumberגובה התמונה בנקודות.

החזרות

Image – התמונה שהוכנסה.

הרשאות

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

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

insertLine(line)

הוספת עותק של Line שסופק בדף.

מיקום הרכיב שנוסף בדף הזה נקבע לפי המיקום של רכיב המקור בדף שלו.

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

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

// Copy a line between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var line = otherPresentationSlide.getLines[0];
currentPresentationSlide.insertLine(line);

פרמטרים

שםתיאורהתיאור
lineLineהשורה להעתקה ולהוספה.

החזרות

Line - השורה שהוכנסה.

הרשאות

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

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

insertLine(lineCategory, startConnectionSite, endConnectionSite)

הוספת שורה בדף המחברת בין שני ערכי connection sites. שני אתרי החיבור חייבים להיות בדף הזה. 

// Insert a line in the first slide of the presentation connecting two shapes.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var shape1 = slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
var shape2 = slide.insertShape(SlidesApp.ShapeType.CLOUD);
slide.insertLine(
    SlidesApp.LineCategory.BENT,
    shape1.getConnectionSites()[0],
    shape2.getConnectionSites()[1]);

פרמטרים

שםתיאורהתיאור
lineCategoryLineCategoryהקטגוריה של השורה שיש להוסיף.
startConnectionSiteConnectionSiteאתר החיבור שבו יש לחבר את תחילת הקו.
endConnectionSiteConnectionSiteאתר החיבור שבו יש לחבר את קצה הקו.

החזרות

Line - השורה שהוכנסה.

הרשאות

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

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

insertLine(lineCategory, startLeft, startTop, endLeft, endTop)

הוספת שורה לדף. 

// Insert a line in the first slide of the presentation.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var startPoint = {left: 10, top: 10};
var endPoint = {left: 40, top: 40};
slide.insertLine(
    SlidesApp.LineCategory.STRAIGHT,
    startPoint.left,
    startPoint.top,
    endPoint.left,
    endPoint.top);

פרמטרים

שםתיאורהתיאור
lineCategoryLineCategoryהקטגוריה של השורה שיש להוסיף.
startLeftNumberהמיקום האופקי של נקודת ההתחלה של הקו, שנמדד בנקודות מהפינה השמאלית העליונה של הדף.
startTopNumberהמיקום האנכי של נקודת ההתחלה של הקו, שנמדד בנקודות מהפינה השמאלית העליונה של הדף.
endLeftNumberהמיקום האופקי של נקודת הקצה של הקו, שנמדד בנקודות מהפינה השמאלית העליונה של הדף.
endTopNumberהמיקום האנכי של נקודת הסיום של הקו, שנמדד בנקודות מהפינה השמאלית העליונה של הדף.

החזרות

Line - השורה שהוכנסה.

הרשאות

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

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

insertPageElement(pageElement)

הוספת עותק של PageElement שסופק בדף.

מיקום הרכיב שנוסף בדף הזה נקבע לפי המיקום של רכיב המקור בדף שלו.

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

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

// Copy a page element between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var pageElement = otherPresentationSlide.getPageElements()[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertPageElement(pageElement);

פרמטרים

שםתיאורהתיאור
pageElementPageElementרכיב הדף להעתקה ולהוספה.

החזרות

PageElement - רכיב הדף שנוסף.

הרשאות

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

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

insertShape(shape)

הוספת עותק של Shape שסופק בדף.

מיקום הרכיב שנוסף בדף הזה נקבע לפי המיקום של רכיב המקור בדף שלו.

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

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

// Copy a shape between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var shape = otherPresentationSlide.getShapes[0];
currentPresentationSlide.insertShape(shape); // Also available for Layout, Master, and Page.

פרמטרים

שםתיאורהתיאור
shapeShapeהצורה להעתקה ולהוספה.

החזרות

Shape - הצורה שהוכנסה.

הרשאות

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

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

insertShape(shapeType)

הוספת צורה לדף.

לצורה מצורף גודל ברירת מחדל בפינה הימנית העליונה של הדף. 

// Insert a shape in the first slide of the presentation.
var slide = SlidesApp.getActivePresentation().getSlides()[0];

// Also available for Layout, Master, and Page.
slide.insertShape(SlidesApp.ShapeType.RECTANGLE);

פרמטרים

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

החזרות

Shape - הצורה שהוכנסה.

הרשאות

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

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

insertShape(shapeType, left, top, width, height)

הוספת צורה לדף.

פרמטרים

שםתיאורהתיאור
shapeTypeShapeTypeסוג הצורה שיש להוסיף.
leftNumberהמיקום האופקי של הצורה, כפי שנמדד מהפינה השמאלית העליונה של הדף.
topNumberהמיקום האנכי של הצורה, כפי שנמדד מהפינה השמאלית העליונה של הדף.
widthNumberרוחב הצורה.
heightNumberגובה הצורה.

החזרות

Shape - הצורה שהוכנסה.

הרשאות

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

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

insertSheetsChart(sourceChart)

הוספת תרשים של Google Sheets לדף.

התרשים מתווסף לגודל ברירת מחדל בפינה הימנית העליונה של הדף.

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

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertSheetsChart(chart);

פרמטרים

שםתיאורהתיאור
sourceChartEmbeddedChartהתרשים בגיליון האלקטרוני שיש להוסיף לדף.

החזרות

SheetsChart - התרשים שנוסף לדף.

הרשאות

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

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

insertSheetsChart(sourceChart, left, top, width, height)

הוספת תרשים של Google Sheets לדף עם המיקום והגודל שצוינו.

כדי לשמור על יחס הגובה-רוחב של התרשים, גודל התרשים וממורכז בהתאם לגודל שצוין.

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

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var position = {left: 0, top: 0};
var size = {width: 200, height: 200};

// Also available for Layout, Master, and Page.
slide.insertSheetsChart(
    chart,
    position.left,
    position.top,
    size.width,
    size.height);

פרמטרים

שםתיאורהתיאור
sourceChartEmbeddedChartהתרשים בגיליון האלקטרוני שיש להוסיף לדף.
leftNumberהמיקום האופקי של התרשים בנקודות, שנמדד מהפינה הימנית העליונה של הדף.
topNumberהמיקום האנכי של התרשים בנקודות, שנמדד מהפינה הימנית העליונה של הדף.
widthNumberרוחב התרשים בנקודות.
heightNumberגובה התרשים בנקודות.

החזרות

SheetsChart - התרשים שנוסף לדף.

הרשאות

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

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

insertSheetsChart(sheetsChart)

הוספת עותק של SheetsChart שסופק בדף.

מיקום הרכיב שנוסף בדף הזה נקבע לפי המיקום של רכיב המקור בדף שלו.

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

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

// Copy a sheets chart between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var sheetsChart = otherPresentationSlide.getSheetsCharts[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertSheetsChart(sheetsChart);

פרמטרים

שםתיאורהתיאור
sheetsChartSheetsChartתרשים הגיליון להעתקה ולהוספה.

החזרות

SheetsChart – תרשים הגיליונות שנוספו.

הרשאות

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

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

insertSheetsChartAsImage(sourceChart)

הוספת תרשים של Google Sheets כ-Image בדף.

תמונת התרשים מצורפת בגודל ברירת מחדל בפינה הימנית העליונה של הדף.

התמונה שהוכנסה של התרשים לא מקושרת לתרשים המקור ב-Google Sheets. 

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertSheetsChartAsImage(chart); // Also available for Layout, Master, and Page.

פרמטרים

שםתיאורהתיאור
sourceChartEmbeddedChartהתרשים בגיליון האלקטרוני שיש להוסיף לדף.

החזרות

Image - התמונה שהוכנסה של התרשים לדף.

הרשאות

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

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

insertSheetsChartAsImage(sourceChart, left, top, width, height)

הוספת תרשים של Google Sheets בפורמט Image בדף, עם המיקום והגודל שצוינו.

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

התמונה שהוכנסה של התרשים לא מקושרת לתרשים המקור ב-Google Sheets. 

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var position = {left: 0, top: 0};
var size = {width: 200, height: 200};

// Also available for Layout, Master, and Page.
slide.insertSheetsChartAsImage(
    chart,
    position.left,
    position.right,
    size.width,
    size.height);

פרמטרים

שםתיאורהתיאור
sourceChartEmbeddedChartהתרשים בגיליון האלקטרוני שיש להוסיף לדף.
leftNumberהמיקום האופקי של התרשים בנקודות, שנמדד מהפינה הימנית העליונה של הדף.
topNumberהמיקום האנכי של התרשים בנקודות, שנמדד מהפינה הימנית העליונה של הדף.
widthNumberרוחב התרשים בנקודות.
heightNumberגובה התרשים בנקודות.

החזרות

Image - התמונה שהוכנסה של התרשים לדף.

הרשאות

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

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

insertTable(numRows, numColumns)

הוספת טבלה לדף.

הטבלה ממורכזת בדף, בגודל ברירת המחדל ובחלוקה שווה של שורות ועמודות.

פרמטרים

שםתיאורהתיאור
numRowsIntegerמספר השורות בטבלה.
numColumnsIntegerמספר העמודות בטבלה.

החזרות

Table – הטבלה שהוכנסה.

הרשאות

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

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

insertTable(numRows, numColumns, left, top, width, height)

הוספת טבלה בדף עם המיקום והגודל שצוינו.

השורות והעמודות מחולקות באופן שווה בטבלה שנוצרה.

פרמטרים

שםתיאורהתיאור
numRowsIntegerמספר השורות בטבלה.
numColumnsIntegerמספר העמודות בטבלה.
leftNumberהמיקום האופקי של הטבלה, שנמדד מהפינה הימנית העליונה של הדף.
topNumberהמיקום האנכי של הטבלה, שנמדד מהפינה הימנית העליונה של הדף.
widthNumberרוחב הטבלה.
heightNumberהגובה המינימלי של הטבלה. הגובה בפועל של הטבלה שעברה רינדור תלוי בגורמים כמו גודל הגופן של הטקסט.

החזרות

Table – הטבלה שהוכנסה.

הרשאות

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

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

insertTable(table)

הוספת עותק של Table שסופק בדף.

מיקום הרכיב שנוסף בדף הזה נקבע לפי המיקום של רכיב המקור בדף שלו.

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

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

// Copy a table between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var table = otherPresentationSlide.getTables[0];
currentPresentationSlide.insertTable(table); // Also available for Layout, Master, and Page.

פרמטרים

שםתיאורהתיאור
tableTableהטבלה להעתקה ולהוספה.

החזרות

Table – הטבלה שהוכנסה.

הרשאות

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

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

insertTextBox(text)

מוסיף תיבת טקסט Shape שמכילה את המחרוזת הנתונה בדף.

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

// Insert text box with "Hello" on the first slide of presentation.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertTextBox('Hello'); // Also available for Layout, Master, and Page.

פרמטרים

שםתיאורהתיאור
textStringהמחרוזת שהצורה של תיבת הטקסט צריכה להכיל.

החזרות

Shape - הצורה של תיבת הטקסט שהוכנסה.

הרשאות

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

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

insertTextBox(text, left, top, width, height)

מוסיף תיבת טקסט Shape שמכילה את המחרוזת הנתונה בדף. 

// Insert text box with "Hello" on the first slide of presentation. This text box is a square
// with a length of 10 points on each side.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertTextBox('Hello', 0, 0, 10, 10); // Also available for Layout, Master, and Page.

פרמטרים

שםתיאורהתיאור
textStringהמחרוזת שהצורה של תיבת הטקסט צריכה להכיל.
leftNumberהמיקום האופקי של הצורה של תיבת הטקסט, שנמדד מהפינה השמאלית העליונה של הדף.
topNumberהמיקום האנכי של הצורה של תיבת הטקסט, כפי שנמדד מהפינה השמאלית העליונה של הדף.
widthNumberרוחב הצורה של תיבת הטקסט.
heightNumberגובה הצורה של תיבת הטקסט.

החזרות

Shape - הצורה של תיבת הטקסט שהוכנסה.

הרשאות

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

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

insertVideo(videoUrl)

מוסיף סרטון בפינה הימנית העליונה של הדף עם גודל ברירת מחדל.

כרגע יש תמיכה בסרטוני YouTube בלבד.

פרמטרים

שםתיאורהתיאור
videoUrlStringכתובת ה-URL של הסרטון להוספה.

החזרות

Video – הסרטון שנוסף.

הרשאות

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

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

insertVideo(videoUrl, left, top, width, height)

הוספת סרטון לדף עם המיקום והגודל שסופקו.

כרגע יש תמיכה בסרטוני YouTube בלבד.

פרמטרים

שםתיאורהתיאור
videoUrlStringכתובת ה-URL של הסרטון להוספה.
leftNumberהמיקום האופקי של הסרטון בנקודות, שנמדד מהפינה השמאלית העליונה של הדף.
topNumberהמיקום האנכי של הסרטון בנקודות, במדידה מהפינה הימנית העליונה של הדף.
widthNumberרוחב הסרטון בנקודות.
heightNumberגובה הסרטון בנקודות.

החזרות

Video – הסרטון שנוסף.

הרשאות

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

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

insertVideo(video)

הוספת עותק של Video שסופק בדף.

מיקום הרכיב שנוסף בדף הזה נקבע לפי המיקום של רכיב המקור בדף שלו.

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

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

// Copy a video between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var video = otherPresentationSlide.getVideos[0];
currentPresentationSlide.insertVideo(video); // Also available for Layout, Master, and Page.

פרמטרים

שםתיאורהתיאור
videoVideoהסרטון להעתקה ולהוספה.

החזרות

Video – הסרטון שנוסף.

הרשאות

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

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

insertWordArt(wordArt)

הוספת עותק של WordArt שסופק בדף.

מיקום הרכיב שנוסף בדף הזה נקבע לפי המיקום של רכיב המקור בדף שלו.

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

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

// Copy a word art between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var wordArt = otherPresentationSlide.getWordArts[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertWordArt(wordArt);

פרמטרים

שםתיאורהתיאור
wordArtWordArtהקבוצה להעתקה ולהוספה.

החזרות

WordArt - המילה המעוצבת שהוכנסה.

הרשאות

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

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

isSkipped()

מחזירה את האפשרות לדלג על השקף במצב 'מצגת'.

החזרות

Boolean – True אם המערכת מדלגת על השקף במצב מצגת.

הרשאות

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

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

move(index)

מעבירים את השקף לאינדקס שצוין.

פרמטרים

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

הרשאות

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

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

refreshSlide()

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

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

var currentPresentation = SlidesApp.getActivePresentation();
var sourcePresentation = SlidesApp.openById('sourcePresentationId');
var sourceSlide = sourcePresentation.getSlides()[0];
var linkedSlide = currentPresentation.append(sourceSlide, SlidesApp.SlideLinkingMode.LINKED);

sourceSlide.insertText('hello world'); // Only the source slide has the text box.

linkedSlide.refreshSlide(); // The linked slide now has the text box.

קליעות

Error – אם אין יותר הרשאת קריאה למצגת המקור.

הרשאות

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

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

remove()

הסרת הדף.

הרשאות

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

  • 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

selectAsCurrentPage()

בוחר ב-Page במצגת הפעילה בתור current page selection ומסיר את כל הבחירה הקודמת.

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

// Select the first slide as the current page selection and replace any previous selection.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.selectAsCurrentPage(); // Also available for Layout, Master, and Page.

הרשאות

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

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

setSkipped(isSkipped)

המדיניות הזו קובעת אם המערכת תדלג על השקף במצב 'מצגת'.

פרמטרים

שםתיאורהתיאור
isSkippedBooleanTrue כדי לדלג על השקף במצב מצגת.

הרשאות

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

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

ביטול הקישור של Slide הנוכחי משקף המקור שלו. אם השקף לא מקושר, הוא חוזר בלי לבצע שינויים. 

var currentPresentation = SlidesApp.getActivePresentation();
var sourcePresentation = SlidesApp.openById('sourcePresentationId');
var sourceSlide = sourcePresentation.getSlides()[0];
var linkedSlide = currentPresentation.append(sourceSlide, SlidesApp.SlideLinkingMode.LINKED);

linkedSlide.unlink();

linkedSlide.getSourcePresentationId(); // returns null
linkedSlide.getSourceSlideObjectId();  // returns null
linkedSlide.getSlideLinkingMode();     // returns SlidesApp.SlideLinkingMode.NOT_LINKED

הרשאות

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

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