דף זה תורגם על ידי Cloud Translation API.

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`	הפונקציה מחזירה את אובייקט ה-placeholder `PageElement` בשביל `PlaceholderType` שצוין, או `null` אם אין placeholder תואם.
`getPlaceholder(placeholderType, placeholderIndex)`	`PageElement`	הפונקציה מחזירה את אובייקט ה-placeholder `PageElement` של `PlaceholderType` שצוין, אינדקס placeholder, או `null` אם ה-placeholder לא קיים.
`getPlaceholders()`	`PageElement[]`	הפונקציה מחזירה את הרשימה של ה-placeholders `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`	הוספת תמונה בפינה הימנית העליונה של הדף בגודל ברירת מחדל מהגודל שצוין או בלי תמונה.
`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`	הפונקציה מחזירה אם לדלג על השקף במצב מצגת.
`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 אם לא קיים.

פרמטרים

שם	סוג	תיאור
`id`	`String`	המזהה של רכיב הדף שמאוחזר.

חזרה

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

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

פרמטרים

שם	סוג	תיאור
`placeholderType`	`PlaceholderType`

חזרה

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 מאוסף רכיבי הדף של הדף.

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

פרמטרים

שם	סוג	תיאור
`placeholderType`	`PlaceholderType`
`placeholderIndex`	`Integer`

חזרה

PageElement

אישור

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

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

`getPlaceholders()`

הפונקציה מחזירה את הרשימה של ה-placeholders 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.

פרמטרים

שם	סוג	תיאור
`pageElements`	`PageElement[]`	הרכיבים לקיבוץ.

חזרה

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.

פרמטרים

שם	סוג	תיאור
`group`	`Group`	הקבוצה להעתקה ולהוספה.

חזרה

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

אישור

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

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

`insertImage(blobSource)`

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

הוספת התמונה תאחזר אותה מה-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);

פרמטרים

שם	סוג	תיאור
`blobSource`	`BlobSource`	נתוני התמונה.

חזרה

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);

פרמטרים

שם	סוג	תיאור
`blobSource`	`BlobSource`	נתוני התמונה.
`left`	`Number`	המיקום האופקי של התמונה בנקודות, כפי שנמדד מהפינה השמאלית העליונה של הדף.
`top`	`Number`	המיקום האנכי של התמונה בנקודות, שנמדד מהפינה השמאלית העליונה של הדף.
`width`	`Number`	רוחב התמונה בנקודות.
`height`	`Number`	גובה התמונה בנקודות.

חזרה

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);

פרמטרים

שם	סוג	תיאור
`image`	`Image`	התמונה להעתקה ולהוספה.

חזרה

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().

פרמטרים

שם	סוג	תיאור
`imageUrl`	`String`	כתובת ה-URL של התמונה.

חזרה

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

אישור

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

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

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

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

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

פרמטרים

שם	סוג	תיאור
`imageUrl`	`String`	כתובת ה-URL של התמונה.
`left`	`Number`	המיקום האופקי של התמונה בנקודות, כפי שנמדד מהפינה השמאלית העליונה של הדף.
`top`	`Number`	המיקום האנכי של התמונה בנקודות, שנמדד מהפינה השמאלית העליונה של הדף.
`width`	`Number`	רוחב התמונה בנקודות.
`height`	`Number`	גובה התמונה בנקודות.

חזרה

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

אישור

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

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

`insertLine(line)`

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

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

אם הרכיב שסופק הוא 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);

פרמטרים

שם	סוג	תיאור
`line`	`Line`	השורה להעתקה ולהוספה.

חזרה

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]);

פרמטרים

שם	סוג	תיאור
`lineCategory`	`LineCategory`	הקטגוריה של השורה להוספה.
`startConnectionSite`	`ConnectionSite`	אתר החיבור שבו יש לחבר את תחילת הקו.
`endConnectionSite`	`ConnectionSite`	אתר החיבור שבו יש לחבר את קצה הקו.

חזרה

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);

פרמטרים

שם	סוג	תיאור
`lineCategory`	`LineCategory`	הקטגוריה של השורה להוספה.
`startLeft`	`Number`	המיקום האופקי של נקודת ההתחלה של הקו, שנמדד בנקודות בפינה הימנית העליונה של הדף.
`startTop`	`Number`	המיקום האנכי של נקודת ההתחלה של הקו, שנמדד בנקודות בפינה הימנית העליונה של הדף.
`endLeft`	`Number`	המיקום האופקי של נקודת הקצה של הקו, שנמדד בנקודות בפינה הימנית העליונה של הדף.
`endTop`	`Number`	המיקום האנכי של נקודת הקצה של הקו, שנמדד בנקודות בפינה הימנית העליונה של הדף.

חזרה

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

אישור

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

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

`insertPageElement(pageElement)`

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

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

אם הרכיב שסופק הוא 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);

פרמטרים

שם	סוג	תיאור
`pageElement`	`PageElement`	רכיב הדף להעתקה ולהוספה.

חזרה

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

אישור

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

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

`insertShape(shape)`

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

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

אם הרכיב שסופק הוא 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.

פרמטרים

שם	סוג	תיאור
`shape`	`Shape`	הצורה שרוצים להעתיק ולהוסיף אותה.

חזרה

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);

פרמטרים

שם	סוג	תיאור
`shapeType`	`ShapeType`	סוג הצורה להוספה.

חזרה

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

אישור

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

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

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

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

פרמטרים

שם	סוג	תיאור
`shapeType`	`ShapeType`	סוג הצורה להוספה.
`left`	`Number`	המיקום האופקי של הצורה, שנמדד מהפינה השמאלית העליונה של הדף הזה.
`top`	`Number`	המיקום האנכי של הצורה, שנמדד מהפינה השמאלית העליונה של הדף.
`width`	`Number`	רוחב הצורה.
`height`	`Number`	גובה הצורה.

חזרה

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);

פרמטרים

שם	סוג	תיאור
`sourceChart`	`EmbeddedChart`	התרשים בגיליון האלקטרוני שרוצים להוסיף לדף.

חזרה

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

אישור

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

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

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

הוספת תרשים מ-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);

פרמטרים

שם	סוג	תיאור
`sourceChart`	`EmbeddedChart`	התרשים בגיליון האלקטרוני שרוצים להוסיף לדף.
`left`	`Number`	המיקום האופקי של התרשים בנקודות, שנמדד מהפינה השמאלית העליונה של הדף.
`top`	`Number`	המיקום האנכי של התרשים בנקודות, שנמדד מהפינה השמאלית העליונה של הדף.
`width`	`Number`	רוחב התרשים בנקודות.
`height`	`Number`	גובה התרשים בנקודות.

חזרה

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

אישור

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

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

`insertSheetsChart(sheetsChart)`

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

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

אם הרכיב שסופק הוא 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);

פרמטרים

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

חזרה

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.

פרמטרים

שם	סוג	תיאור
`sourceChart`	`EmbeddedChart`	התרשים בגיליון האלקטרוני שרוצים להוסיף לדף.

חזרה

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);

פרמטרים

שם	סוג	תיאור
`sourceChart`	`EmbeddedChart`	התרשים בגיליון האלקטרוני שרוצים להוסיף לדף.
`left`	`Number`	המיקום האופקי של התרשים בנקודות, שנמדד מהפינה השמאלית העליונה של הדף.
`top`	`Number`	המיקום האנכי של התרשים בנקודות, שנמדד מהפינה השמאלית העליונה של הדף.
`width`	`Number`	רוחב התרשים בנקודות.
`height`	`Number`	גובה התרשים בנקודות.

חזרה

Image – התמונה של התרשים שנוספו לדף.

אישור

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

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

`insertTable(numRows, numColumns)`

מוסיפה טבלה לדף.

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

פרמטרים

שם	סוג	תיאור
`numRows`	`Integer`	מספר השורות בטבלה.
`numColumns`	`Integer`	מספר העמודות בטבלה.

חזרה

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

אישור

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

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

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

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

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

פרמטרים

שם	סוג	תיאור
`numRows`	`Integer`	מספר השורות בטבלה.
`numColumns`	`Integer`	מספר העמודות בטבלה.
`left`	`Number`	המיקום האופקי של הטבלה, במדידה מהפינה השמאלית העליונה של הדף הזה.
`top`	`Number`	המיקום האנכי של הטבלה, במדידה מהפינה הימנית העליונה של הדף.
`width`	`Number`	רוחב הטבלה.
`height`	`Number`	הגובה המינימלי של הטבלה. הגובה בפועל של הטבלה המעובדת תלוי בהתאם לגורמים כמו גודל הגופן של הטקסט.

חזרה

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

אישור

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

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

`insertTable(table)`

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

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

אם הרכיב שסופק הוא 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.

פרמטרים

שם	סוג	תיאור
`table`	`Table`	הטבלה שרוצים להעתיק ולהוסיף אליה.

חזרה

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.

פרמטרים

שם	סוג	תיאור
`text`	`String`	המחרוזת שהצורה של תיבת הטקסט צריכה להכיל.

חזרה

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.

פרמטרים

שם	סוג	תיאור
`text`	`String`	המחרוזת שהצורה של תיבת הטקסט צריכה להכיל.
`left`	`Number`	המיקום האופקי של צורת תיבת הטקסט, שנמדד מהפינה השמאלית העליונה של הדף.
`top`	`Number`	המיקום האנכי של צורת תיבת הטקסט, הנמדד מהפינה השמאלית העליונה של הדף.
`width`	`Number`	רוחב הצורה של תיבת הטקסט.
`height`	`Number`	גובה הצורה של תיבת הטקסט.

חזרה

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

אישור

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

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

`insertVideo(videoUrl)`

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

בשלב זה, יש תמיכה רק בסרטוני YouTube.

פרמטרים

שם	סוג	תיאור
`videoUrl`	`String`	כתובת ה-URL של הסרטון להוספה.

חזרה

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

אישור

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

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

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

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

בשלב זה, יש תמיכה רק בסרטוני YouTube.

פרמטרים

שם	סוג	תיאור
`videoUrl`	`String`	כתובת ה-URL של הסרטון להוספה.
`left`	`Number`	המיקום האופקי של הסרטון בנקודות, שנמדד מהפינה השמאלית העליונה של הדף.
`top`	`Number`	המיקום האנכי של הסרטון בנקודות, שנמדד מהפינה השמאלית העליונה של הדף.
`width`	`Number`	רוחב הסרטון בנקודות.
`height`	`Number`	גובה הסרטון בנקודות.

חזרה

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

אישור

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

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

`insertVideo(video)`

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

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

אם הרכיב שסופק הוא 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.

פרמטרים

שם	סוג	תיאור
`video`	`Video`	הסרטון שרוצים להעתיק ולהוסיף אותו.

חזרה

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

אישור

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

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

`insertWordArt(wordArt)`

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

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

אם הרכיב שסופק הוא 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);

פרמטרים

שם	סוג	תיאור
`wordArt`	`WordArt`	הקבוצה להעתקה ולהוספה.

חזרה

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)`

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

פרמטרים

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

אישור

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

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)`

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

פרמטרים

שם	סוג	תיאור
`findText`	`String`	הטקסט לחיפוש.
`replaceText`	`String`	הטקסט שיחליף את הטקסט המותאם.

חזרה

Integer – מספר המופעים השתנה

אישור

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

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

`replaceAllText(findText, replaceText, matchCase)`

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

פרמטרים

שם	סוג	תיאור
`findText`	`String`	הטקסט לחיפוש.
`replaceText`	`String`	הטקסט שיחליף את הטקסט המותאם.
`matchCase`	`Boolean`	אם הערך שלו הוא `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)`

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

פרמטרים

שם	סוג	תיאור
`isSkipped`	`Boolean`	`True` כדי לדלג על השקף במצב מצגת.

אישור

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

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

`unlink()`

ביטול הקישור של 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