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

Class Slide

שקף במצגת.

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

Methods

שיטה	סוג הערך שמוחזר	תיאור קצר
`duplicate()`	`Slide`	משכפל את השקף.
`getBackground()`	`PageBackground`	הפונקציה מחזירה את הרקע של הדף.
`getColorScheme()`	`ColorScheme`	הפונקציה מחזירה את `ColorScheme` שמשויך לדף.
`getGroups()`	`Group[]`	מחזירה את רשימת האובייקטים `Group` בדף.
`getImages()`	`Image[]`	מחזירה את רשימת האובייקטים `Image` בדף.
`getLayout()`	`Layout\|null`	מחזירה את הפריסה שהשקף מבוסס עליה או `null` אם השקף לא מבוסס על פריסה.
`getLines()`	`Line[]`	מחזירה את רשימת האובייקטים `Line` בדף.
`getNotesPage()`	`NotesPage`	הפונקציה מחזירה את דף ההערות שמשויך לשקף.
`getObjectId()`	`String`	מחזירה את המזהה הייחודי של הדף.
`getPageElementById(id)`	`PageElement\|null`	הפונקציה מחזירה את `PageElement` בדף עם המזהה הנתון, או `null` אם לא קיים כזה.
`getPageElements()`	`PageElement[]`	הפונקציה מחזירה את רשימת האובייקטים `PageElement` שמוצגים בדף.
`getPageType()`	`PageType`	הפונקציה מחזירה את סוג הדף.
`getPlaceholder(placeholderType)`	`PageElement\|null`	מחזירה את האובייקט של placeholder‏ `PageElement` עבור `PlaceholderType` או `null` שצוינו, אם לא קיים placeholder תואם.
`getPlaceholder(placeholderType, placeholderIndex)`	`PageElement\|null`	הפונקציה מחזירה את אובייקט ה-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 אם המערכת מדלגת על השקף במצב הצגה, ואת הערך false אם לא.
`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|null

אישור

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

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|null – רכיב הדף עם המזהה הנתון.

אישור

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

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

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

פרמטרים

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

חזרה

PageElement|null

אישור

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

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

`getPlaceholder(placeholderType, placeholderIndex)`

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

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

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

פרמטרים

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

חזרה

PageElement|null

אישור

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

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.

פרמטרים

שם	סוג	תיאור
`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.
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.

פרמטרים

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

חזרה

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

פרמטרים

שם	סוג	תיאור
`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.

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

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

פרמטרים

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

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

פרמטרים

שם	סוג	תיאור
`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 שצוין לדף.

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

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

פרמטרים

שם	סוג	תיאור
`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.
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],
);

פרמטרים

שם	סוג	תיאור
`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.
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,
);

פרמטרים

שם	סוג	תיאור
`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 שצוין לדף.

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

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

פרמטרים

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

חזרה

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

אישור

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

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

`insertShape(shape)`

התג מכניס עותק של Shape שצוין לדף.

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

// 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.

פרמטרים

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

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

פרמטרים

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

חזרה

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

אישור

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

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

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

הפונקציה מוסיפה לדף תרשים של 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,
);

פרמטרים

שם	סוג	תיאור
`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 שצוין לדף.

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

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

פרמטרים

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

חזרה

‫SheetsChart — התרשים שהוספתם מ-Sheets.

אישור

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

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.

פרמטרים

שם	סוג	תיאור
`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.

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

פרמטרים

שם	סוג	תיאור
`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 שצוין לדף.

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

// 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.

פרמטרים

שם	סוג	תיאור
`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.
const 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.
const 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 שצוין לדף.

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

// 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.

פרמטרים

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

חזרה

‫Video – הסרטון שמוסיפים.

אישור

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

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

`insertWordArt(wordArt)`

התג מכניס עותק של WordArt שצוין לדף.

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

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

פרמטרים

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

חזרה

‫WordArt – אובייקט הטקסט המעוצב שנוסף.

אישור

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

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

`isSkipped()`

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

חזרה

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

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

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

פרמטרים

שם	סוג	תיאור
`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.
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)`

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

פרמטרים

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

אישור

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

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

`unlink()`

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

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

Methods

תיעוד מפורט

duplicate()

חזרה

אישור

getBackground()

חזרה

אישור

getColorScheme()

חזרה

אישור

getGroups()

חזרה

אישור

getImages()

חזרה

אישור

getLayout()

חזרה

אישור

getLines()

חזרה

אישור

getNotesPage()

חזרה

אישור

getObjectId()

חזרה

אישור

getPageElementById(id)

פרמטרים

חזרה

אישור

getPageElements()

חזרה

אישור

getPageType()

חזרה

אישור

getPlaceholder(placeholderType)

פרמטרים

חזרה

אישור

getPlaceholder(placeholderType, placeholderIndex)

פרמטרים

חזרה

אישור

getPlaceholders()

חזרה

אישור

getShapes()

חזרה

אישור

getSheetsCharts()

חזרה

אישור

getSlideLinkingMode()

חזרה

אישור

getSourcePresentationId()

חזרה

אישור

getSourceSlideObjectId()

חזרה

אישור

getTables()

חזרה

אישור

getVideos()

חזרה

אישור

getWordArts()

חזרה

אישור

group(pageElements)

פרמטרים

חזרה

אישור

insertGroup(group)

Class Slide

`duplicate()`

`getBackground()`

`getColorScheme()`

`getGroups()`

`getImages()`

`getLayout()`

`getLines()`

`getNotesPage()`

`getObjectId()`

`getPageElementById(id)`

`getPageElements()`

`getPageType()`

`getPlaceholder(placeholderType)`

`getPlaceholder(placeholderType, placeholderIndex)`

`getPlaceholders()`

`getShapes()`

`getSheetsCharts()`

`getSlideLinkingMode()`

`getSourcePresentationId()`

`getSourceSlideObjectId()`

`getTables()`

`getVideos()`

`getWordArts()`

`group(pageElements)`

`insertGroup(group)`

`insertImage(blobSource)`

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

`insertImage(image)`

`insertImage(imageUrl)`

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

`insertLine(line)`

`insertLine(lineCategory, startConnectionSite, endConnectionSite)`

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

`insertPageElement(pageElement)`

`insertShape(shape)`

`insertShape(shapeType)`

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

`insertSheetsChart(sourceChart)`

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

`insertSheetsChart(sheetsChart)`

`insertSheetsChartAsImage(sourceChart)`

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