דף במצגת.
Methods
| שיטה | סוג הערך שמוחזר | תיאור קצר |
|---|---|---|
as | Layout | הפונקציה מחזירה את הדף כפריסה. |
as | Master | הפונקציה מחזירה את הדף כתבנית. |
as | Slide | הדף מוחזר כשקף. |
get | Page | הפונקציה מחזירה את הרקע של הדף. |
get | Color | מחזירה את Color שמשויך לדף. |
get | Group[] | מחזירה את רשימת האובייקטים Group בדף. |
get | Image[] | מחזירה את רשימת האובייקטים Image בדף. |
get | Line[] | מחזירה את רשימת האובייקטים Line בדף. |
get | String | מחזירה את המזהה הייחודי של הדף. |
get | Page | הפונקציה מחזירה את Page בדף עם המזהה הנתון, או null אם לא קיים כזה. |
get | Page | מחזירה את רשימת האובייקטים Page שמוצגים בדף. |
get | Page | הפונקציה מחזירה את סוג הדף. |
get | Page | מחזירה את אובייקט ה-placeholder Page של Placeholder או null שצוין, אם לא קיים placeholder תואם. |
get | Page | מחזירה את אובייקט ה-placeholder Page של Placeholder שצוין ושל אינדקס placeholder, או null אם ה-placeholder לא קיים. |
get | Page | מחזירה את רשימת האובייקטים של ה-placeholder Page בדף. |
get | Shape[] | מחזירה את רשימת האובייקטים Shape בדף. |
get | Sheets | מחזירה את רשימת האובייקטים Sheets בדף. |
get | Table[] | מחזירה את רשימת האובייקטים Table בדף. |
get | Video[] | מחזירה את רשימת האובייקטים Video בדף. |
get | Word | מחזירה את רשימת האובייקטים Word בדף. |
group(pageElements) | Group | מקבץ את כל רכיבי הדף שצוינו. |
insert | Group | התג מכניס עותק של Group שצוין לדף. |
insert | Image | התג מוסיף תמונה בפינה השמאלית העליונה של הדף בגודל ברירת מחדל מתוך blob התמונה שצוין. |
insert | Image | הפונקציה מוסיפה לדף תמונה עם המיקום והגודל שצוינו מתוך אובייקט ה-Blob של התמונה. |
insert | Image | התג מכניס עותק של Image שצוין לדף. |
insert | Image | התג מוסיף תמונה בפינה השמאלית העליונה של הדף בגודל ברירת מחדל מכתובת ה-URL שצוינה. |
insert | Image | הפעולה מוסיפה לדף תמונה עם המיקום והגודל שצוינו מכתובת ה-URL שצוינה. |
insert | Line | התג מכניס עותק של Line שצוין לדף. |
insert | Line | מוסיף קו בדף שמקשר בין שני connection sites. |
insert | Line | הוספת קו בדף. |
insert | Page | התג מכניס עותק של Page שצוין לדף. |
insert | Shape | התג מכניס עותק של Shape שצוין לדף. |
insert | Shape | הוספת צורה לדף. |
insert | Shape | הוספת צורה לדף. |
insert | Sheets | הוספה של תרשים מ-Google Sheets לדף. |
insert | Sheets | הפונקציה מוסיפה לדף תרשים של Google Sheets במיקום ובגודל שצוינו. |
insert | Sheets | התג מכניס עותק של Sheets שצוין לדף. |
insert | Image | הוספת תרשים של Google Sheets כImage בדף. |
insert | Image | מוסיף תרשים של Google Sheets כ-Image בדף עם המיקום והגודל שצוינו. |
insert | Table | הוספת טבלה לדף. |
insert | Table | הפונקציה מוסיפה טבלה לדף עם המיקום והגודל שצוינו. |
insert | Table | התג מכניס עותק של Table שצוין לדף. |
insert | Shape | מוסיף תיבת טקסט Shape שמכילה את המחרוזת שצוינה בדף. |
insert | Shape | מוסיף תיבת טקסט Shape שמכילה את המחרוזת שצוינה בדף. |
insert | Video | התג מוסיף סרטון בפינה השמאלית העליונה של הדף בגודל ברירת מחדל. |
insert | Video | הפונקציה מוסיפה סרטון לדף עם המיקום והגודל שצוינו. |
insert | Video | התג מכניס עותק של Video שצוין לדף. |
insert | Word | התג מכניס עותק של Word שצוין לדף. |
remove() | void | הדף יוסר. |
replace | Integer | הפונקציה מחליפה את כל המופעים של הטקסט שתואם לטקסט לחיפוש בטקסט להחלפה. |
replace | Integer | הפונקציה מחליפה את כל המופעים של הטקסט שתואם לטקסט לחיפוש בטקסט להחלפה. |
select | void | בחירת השקף Page במצגת הפעילה כcurrent page selection והסרת כל בחירה קודמת. |
תיעוד מפורט
asLayout()
asMaster()
asSlide()
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()
getImages()
getLines()
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 שמוצגים בדף.
חזרה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
getPageType()
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, );
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
placeholder | Placeholder | סוג הפלייסהולדר להתאמה. |
חזרה
PageElement|null – מרכיב דף placeholder, או 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, );
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
placeholder | Placeholder | סוג הפלייסהולדר להתאמה. |
placeholder | Integer | אינדקס מציין המיקום שצריך למצוא לו התאמה. |
חזרה
PageElement|null – מרכיב דף placeholder, או 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}`, );
חזרה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
getShapes()
getSheetsCharts()
מחזירה את רשימת האובייקטים SheetsChart בדף.
חזרה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
getTables()
getVideos()
getWordArts()
group(pageElements)
מקבץ את כל רכיבי הדף שצוינו.
צריכים להיות לפחות שני רכיבי דף באותו דף שלא נכללים כבר בקבוצה אחרת. אי אפשר לקבץ חלק מרכיבי הדף, כמו Videos, Tables ו-placeholder Shapes.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
page | Page | האלמנטים שרוצים לקבץ. |
חזרה
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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
blob | Blob | נתוני התמונה. |
חזרה
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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
blob | Blob | נתוני התמונה. |
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().
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
image | String | כתובת ה-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().
כדי לשמור על יחס הגובה-רוחב של התמונה, המערכת משנה את גודל התמונה וממקמת אותה במרכז ביחס לגודל שצוין.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
image | 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 שמועתק מתוך המצגת הנוכחית, מאפיינים שעוברים בירושה מדפי תבנית או מדפי פריסה עוברים בירושה גם ברכיב שנוסף.
אם הרכיב שצוין הוא placeholder שמועתק ממצגת אחרת, המאפיינים שעוברים בירושה מדפי התבנית או הפריסה מועתקים לרכיב ממצגת המקור.
// 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], );
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
line | Line | הקטגוריה של השורה שרוצים להוסיף. |
start | Connection | אתר החיבור שאליו צריך לחבר את תחילת הקו. |
end | Connection | אתר החיבור שאליו צריך לחבר את קצה הקו. |
חזרה
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, );
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
line | Line | הקטגוריה של השורה שרוצים להוסיף. |
start | Number | המיקום האופקי של נקודת ההתחלה של הקו, נמדד בנקודות מהפינה הימנית העליונה של הדף. |
start | Number | המיקום האנכי של נקודת ההתחלה של הקו, שנמדד בנקודות מהפינה הימנית העליונה של הדף. |
end | Number | המיקום האופקי של נקודת הסיום של הקו, שנמדד בנקודות מהפינה השמאלית העליונה של הדף. |
end | Number | המיקום האנכי של נקודת הקצה של הקו, שנמדד בנקודות מהפינה השמאלית העליונה של הדף. |
חזרה
Line – השורה שנוספה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
insertPageElement(pageElement)
התג מכניס עותק של PageElement שצוין לדף.
המיקום של האלמנט שנוסף בדף הזה נקבע לפי המיקום של אלמנט המקור בדף המתאים.
אם הרכיב שצוין הוא placeholder שמועתק מתוך המצגת הנוכחית, מאפיינים שעוברים בירושה מדפי תבנית או מדפי פריסה עוברים בירושה גם ברכיב שנוסף.
אם הרכיב שצוין הוא placeholder שמועתק ממצגת אחרת, המאפיינים שעוברים בירושה מדפי התבנית או הפריסה מועתקים לרכיב ממצגת המקור.
// Copy a page element between presentations. 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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
page | Page | רכיב הדף שרוצים להעתיק ולהוסיף. |
חזרה
PageElement – מרכיב הדף שנוסף.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
insertShape(shape)
התג מכניס עותק של Shape שצוין לדף.
המיקום של האלמנט שנוסף בדף הזה נקבע לפי המיקום של אלמנט המקור בדף המתאים.
אם הרכיב שצוין הוא placeholder שמועתק מתוך המצגת הנוכחית, מאפיינים שעוברים בירושה מדפי תבנית או מדפי פריסה עוברים בירושה גם ברכיב שנוסף.
אם הרכיב שצוין הוא placeholder שמועתק ממצגת אחרת, המאפיינים שעוברים בירושה מדפי התבנית או הפריסה מועתקים לרכיב ממצגת המקור.
// 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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
shape | Shape | סוג הצורה שרוצים להוסיף. |
חזרה
Shape – הצורה שנוספה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
insertShape(shapeType, left, top, width, height)
הוספת צורה לדף.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
shape | Shape | סוג הצורה שרוצים להוסיף. |
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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
source | Embedded | התרשים בגיליון האלקטרוני שרוצים להוסיף לדף. |
חזרה
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, );
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
source | Embedded | התרשים בגיליון האלקטרוני שרוצים להוסיף לדף. |
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 שמועתק מתוך המצגת הנוכחית, מאפיינים שעוברים בירושה מדפי תבנית או מדפי פריסה עוברים בירושה גם ברכיב שנוסף.
אם הרכיב שצוין הוא placeholder שמועתק ממצגת אחרת, המאפיינים שעוברים בירושה מדפי התבנית או הפריסה מועתקים לרכיב ממצגת המקור.
// 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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
sheets | Sheets | התרשים בגיליון שרוצים להעתיק ולהוסיף. |
חזרה
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.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
source | Embedded | התרשים בגיליון האלקטרוני שרוצים להוסיף לדף. |
חזרה
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, );
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
source | Embedded | התרשים בגיליון האלקטרוני שרוצים להוסיף לדף. |
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)
הוספת טבלה לדף.
הטבלה ממוקמת במרכז הדף עם גודל ברירת מחדל ושורות ועמודות מחולקות באופן שווה.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
num | Integer | מספר השורות בטבלה. |
num | Integer | מספר העמודות בטבלה. |
חזרה
Table – הטבלה שנוספה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
insertTable(numRows, numColumns, left, top, width, height)
הפונקציה מוסיפה טבלה לדף עם המיקום והגודל שצוינו.
השורות והעמודות מחולקות באופן שווה בטבלה שנוצרה.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
num | Integer | מספר השורות בטבלה. |
num | 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 שמועתק מתוך המצגת הנוכחית, מאפיינים שעוברים בירושה מדפי תבנית או מדפי פריסה עוברים בירושה גם ברכיב שנוסף.
אם הרכיב שצוין הוא placeholder שמועתק ממצגת אחרת, המאפיינים שעוברים בירושה מדפי התבנית או הפריסה מועתקים לרכיב ממצגת המקור.
// 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.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
video | String | כתובת ה-URL של הסרטון שרוצים להוסיף. |
חזרה
Video – הסרטון שמוסיפים.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
insertVideo(videoUrl, left, top, width, height)
הפונקציה מוסיפה סרטון לדף עם המיקום והגודל שצוינו.
בשלב הזה יש תמיכה רק בסרטוני YouTube.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
video | 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 שמועתק מתוך המצגת הנוכחית, מאפיינים שעוברים בירושה מדפי תבנית או מדפי פריסה עוברים בירושה גם ברכיב שנוסף.
אם הרכיב שצוין הוא placeholder שמועתק ממצגת אחרת, המאפיינים שעוברים בירושה מדפי התבנית או הפריסה מועתקים לרכיב ממצגת המקור.
// 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 שצוין לדף.
המיקום של האלמנט שנוסף בדף הזה נקבע לפי המיקום של אלמנט המקור בדף המתאים.
אם הרכיב שצוין הוא placeholder שמועתק מתוך המצגת הנוכחית, מאפיינים שעוברים בירושה מדפי תבנית או מדפי פריסה עוברים בירושה גם ברכיב שנוסף.
אם הרכיב שצוין הוא placeholder שמועתק ממצגת אחרת, המאפיינים שעוברים בירושה מדפי התבנית או הפריסה מועתקים לרכיב ממצגת המקור.
// 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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
word | Word | הקבוצה שרוצים להעתיק ולהוסיף. |
חזרה
WordArt – אובייקט הטקסט המעוצב שנוסף.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
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)
הפונקציה מחליפה את כל המופעים של הטקסט שתואם לטקסט לחיפוש בטקסט להחלפה. החיפוש לא תלוי אותיות רישיות.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
find | String | הטקסט לחיפוש. |
replace | String | הטקסט שיחליף את הטקסט התואם. |
חזרה
Integer — מספר המופעים השתנה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
replaceAllText(findText, replaceText, matchCase)
הפונקציה מחליפה את כל המופעים של הטקסט שתואם לטקסט לחיפוש בטקסט להחלפה.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
find | String | הטקסט לחיפוש. |
replace | String | הטקסט שיחליף את הטקסט התואם. |
match | 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