פריסה במצגת.
כל פריסה משמשת כתבנית לשקפים שמוגדרים לפיה, וקובעת איך התוכן בשקפים האלה מסודר ומעוצב.
Methods
| שיטה | סוג הערך שמוחזר | תיאור קצר |
|---|---|---|
get | Page | הפונקציה מחזירה את הרקע של הדף. |
get | Color | הפונקציה מחזירה את Color שמשויך לדף. |
get | Group[] | מחזירה את רשימת האובייקטים Group בדף. |
get | Image[] | מחזירה את רשימת האובייקטים Image בדף. |
get | String | מחזירה את השם של הפריסה. |
get | Line[] | מחזירה את רשימת האובייקטים Line בדף. |
get | Master | מחזירה את שקף האב שהפריסה מבוססת עליו. |
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 והסרת כל בחירה קודמת. |
תיעוד מפורט
get Background()
הפונקציה מחזירה את הרקע של הדף.
חזרה
Page — הרקע של הדף.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
get Color Scheme()
הפונקציה מחזירה את Color שמשויך לדף.
חזרה
Color – ערכת הצבעים של הדף.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
get Groups()
get Images()
get Layout Name()
מחזירה את השם של הפריסה.
חזרה
String
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
get Lines()
get Master()
get Object Id()
מחזירה את המזהה הייחודי של הדף. מזהי האובייקטים שמשמשים דפים ורכיבי דפים חולקים את אותו מרחב שמות.
חזרה
String
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
get Page Element By Id(id)
הפונקציה מחזירה את Page בדף עם המזהה הנתון, או null אם לא קיים כזה.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
id | String | המזהה של רכיב הדף שאותו מאחזרים. |
חזרה
Page – רכיב הדף עם המזהה הנתון.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
get Page Elements()
הפונקציה מחזירה את רשימת האובייקטים Page שמוצגים בדף.
חזרה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
get Page Type()
get Placeholder(placeholderType)
מחזירה את האובייקט של placeholder Page עבור Placeholder או null שצוינו, אם לא קיים placeholder תואם.
אם יש כמה placeholders מאותו סוג, הפונקציה מחזירה את ה-placeholder עם האינדקס המינימלי. אם יש כמה placeholder תואמים עם אותו אינדקס, הפונקציה מחזירה את ה-placeholder הראשון מתוך אוסף רכיבי הדף של הדף.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; const placeholder = slide.getPlaceholder( SlidesApp.PlaceholderType.CENTERED_TITLE, );
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
placeholder | Placeholder |
חזרה
Page
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
get Placeholder(placeholderType, placeholderIndex)
הפונקציה מחזירה את אובייקט ה-placeholder Page עבור Placeholder שצוין ואינדקס של placeholder, או null אם ה-placeholder לא קיים.
אם יש כמה placeholder מאותו סוג ומאותו אינדקס, הפונקציה מחזירה את ה-placeholder הראשון מתוך אוסף רכיבי הדף של הדף.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; const placeholder = slide.getPlaceholder( SlidesApp.PlaceholderType.CENTERED_TITLE, 0, );
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
placeholder | Placeholder | |
placeholder | Integer |
חזרה
Page
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
get Placeholders()
הפונקציה מחזירה את רשימת האובייקטים של ה-placeholder Page בדף.
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
get Shapes()
get Sheets Charts()
מחזירה את רשימת האובייקטים Sheets בדף.
חזרה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
get Tables()
get Videos()
get Word Arts()
group(pageElements)
מקבץ את כל רכיבי הדף שצוינו.
צריכים להיות לפחות שני רכיבי דף באותו דף שלא נמצאים כבר בקבוצה אחרת. אי אפשר לקבץ חלק מרכיבי הדף, כמו Videos, Tables ו-placeholder Shapes.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
page | Page | האלמנטים שרוצים לקבץ. |
חזרה
Group — הקבוצה החדשה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
insert Group(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
insert Image(blobSource)
התג מוסיף תמונה בפינה השמאלית העליונה של הדף בגודל ברירת מחדל מתוך blob התמונה שצוין.
כשמוסיפים את התמונה, היא נשלפת מ-Blob פעם אחת ועותק שלה נשמר להצגה במצגת. גודל התמונות צריך להיות פחות מ-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
insert Image(blobSource, left, top, width, height)
הפונקציה מוסיפה לדף תמונה עם המיקום והגודל שצוינו מתוך אובייקט ה-Blob של התמונה.
התמונה מאוחזרת ממאפיין הקישור לתמונה [Blob] שצוין פעם אחת בזמן ההוספה, ועותק שלה נשמר להצגה במצגת. התמונות צריכות להיות קטנות מ-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
insert Image(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
insert Image(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
insert Image(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
insert Line(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
insert Line(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
insert Line(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
insert Page Element(pageElement)
התג מכניס עותק של Page שצוין לדף.
המיקום של האלמנט שנוסף בדף הזה נקבע לפי המיקום של אלמנט המקור בדף המתאים.
אם הרכיב שצוין הוא 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 | רכיב הדף שרוצים להעתיק ולהוסיף. |
חזרה
Page – מרכיב הדף שנוסף.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
insert Shape(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
insert Shape(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
insert Shape(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
insert Sheets Chart(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 | התרשים בגיליון האלקטרוני שרוצים להוסיף לדף. |
חזרה
Sheets – התרשים שנוסף לדף.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
insert Sheets Chart(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 | גובה התרשים בנקודות. |
חזרה
Sheets – התרשים שנוסף לדף.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
insert Sheets Chart(sheetsChart)
התג מכניס עותק של Sheets שצוין לדף.
המיקום של האלמנט שנוסף בדף הזה נקבע לפי המיקום של אלמנט המקור בדף המתאים.
אם הרכיב שצוין הוא 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 | התרשים בגיליון שרוצים להעתיק ולהוסיף. |
חזרה
Sheets — התרשים שהוספתם מ-Sheets.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
insert Sheets Chart As Image(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
insert Sheets Chart As Image(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
insert Table(numRows, numColumns)
הוספת טבלה לדף.
הטבלה ממוקמת במרכז הדף עם גודל ברירת מחדל ושורות ועמודות מחולקות באופן שווה.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
num | Integer | מספר השורות בטבלה. |
num | Integer | מספר העמודות בטבלה. |
חזרה
Table – הטבלה שנוספה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
insert Table(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
insert Table(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
insert Text Box(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
insert Text Box(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
insert Video(videoUrl)
התג מוסיף סרטון בפינה השמאלית העליונה של הדף בגודל ברירת מחדל.
בשלב הזה יש תמיכה רק בסרטוני YouTube.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
video | String | כתובת ה-URL של הסרטון שרוצים להוסיף. |
חזרה
Video – הסרטון שמוסיפים.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
insert Video(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
insert Video(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
insert Word Art(wordArt)
התג מכניס עותק של Word שצוין לדף.
המיקום של האלמנט שנוסף בדף הזה נקבע לפי המיקום של אלמנט המקור בדף המתאים.
אם הרכיב שצוין הוא 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 | הקבוצה שרוצים להעתיק ולהוסיף. |
חזרה
Word – אובייקט הטקסט המעוצב שנוסף.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
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
replace All Text(findText, replaceText)
הפונקציה מחליפה את כל המופעים של הטקסט שתואם לטקסט לחיפוש בטקסט להחלפה. החיפוש לא תלוי אותיות רישיות.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
find | String | הטקסט לחיפוש. |
replace | String | הטקסט שיחליף את הטקסט התואם. |
חזרה
Integer – מספר המקרים השתנה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
replace All Text(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
select As Current Page()
בחירת השקף 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