Class Slide

שקף

שקף במצגת.

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

Methods

שיטהסוג הערך המוחזרתיאור קצר
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הפונקציה מחזירה את אובייקט placeholder‏ PageElement עבור PlaceholderType או null שצוין, אם לא קיים placeholder תואם.
getPlaceholder(placeholderType, placeholderIndex)PageElementהפונקציה מחזירה את אובייקט placeholder‏ PageElement עבור 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הוספת תמונה לפינה השמאלית העליונה של הדף בגודל ברירת המחדל מכתובת ה-URL שצוינה.
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הפונקציה מחזירה את הערך 'true' אם השקף ינוקד במצב הצגה.
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)

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

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

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const 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)

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

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

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const 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 בדף. 

const 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 שמועתק מהצגה אחרת, נכסים שעוברים בירושה מדפי master או פריסה מועתקים לרכיב מהצגת המקור. 

// Copy a group between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const 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. 

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
const image = DriveApp.getFileById('123abc');
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.

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

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
const image = DriveApp.getFileById('123abc');
const position = {
  left: 0,
  top: 0
};
const 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.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const 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 שצוינה.

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

// Copy a line between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const 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.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const shape1 = slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
const 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.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const startPoint = {
  left: 10,
  top: 10
};
const 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 שמועתק מהצגה אחרת, נכסים שעוברים בירושה מדפי master או פריסה מועתקים לרכיב מהצגת המקור. 

// Copy a page element between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const 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 שמועתק מהצגה אחרת, נכסים שעוברים בירושה מדפי master או פריסה מועתקים לרכיב מהצגת המקור. 

// Copy a shape between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const 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.
const 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, כך שאפשר לעדכן אותו. שותפי עריכה אחרים יכולים לראות את הקישור לגיליון האלקטרוני המקורי. 

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const 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, כך שאפשר לעדכן אותו. שותפי עריכה אחרים יכולים לראות את הקישור לגיליון האלקטרוני המקורי. 

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const position = {
  left: 0,
  top: 0
};
const 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 שמועתק מהצגה אחרת, נכסים שעוברים בירושה מדפי master או פריסה מועתקים לרכיב מהצגת המקור. 

// Copy a sheets chart between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const 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. 

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const 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. 

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const position = {
  left: 0,
  top: 0
};
const 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 שמועתק מהצגה אחרת, נכסים שעוברים בירושה מדפי master או פריסה מועתקים לרכיב מהצגת המקור. 

// Copy a table between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const 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.
const 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.
const 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 שמועתק מהצגה אחרת, נכסים שעוברים בירושה מדפי master או פריסה מועתקים לרכיב מהצגת המקור. 

// Copy a video between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const 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 שמועתק מהצגה אחרת, נכסים שעוברים בירושה מדפי master או פריסה מועתקים לרכיב מהצגת המקור. 

// Copy a word art between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const 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()

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

חזרה

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

const currentPresentation = SlidesApp.getActivePresentation();
const sourcePresentation = SlidesApp.openById('sourcePresentationId');
const sourceSlide = sourcePresentation.getSlides()[0];
const 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.
const 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 הנוכחי לשקף המקור שלו. אם השקופית הזו לא מקושרת, המערכת תחזיר את המצב ללא שינויים. 

const currentPresentation = SlidesApp.getActivePresentation();
const sourcePresentation = SlidesApp.openById('sourcePresentationId');
const sourceSlide = sourcePresentation.getSlides()[0];
const 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