Class SlidesApp

אפליקצייתSlides

יצירת קובץ Presentations שאפשר לערוך ופתיחתו. 

// Open a presentation by ID.
let preso = SlidesApp.openById('PRESENTATION_ID_GOES_HERE');

// Create and open a presentation.
preso = SlidesApp.create('Presentation Name');

מאפיינים

נכססוגתיאור
AlignmentPositionAlignmentPositionספירה של סוגי מיקומי ההתאמה.
ArrowStyleArrowStyleאנטומציה של סגנונות החצים השונים שיכולים להיות ל-Line.
AutoTextTypeAutoTextTypeספירה של סוגי הטקסט האוטומטי.
AutofitTypeAutofitTypeספירה של סוגי התאמה אוטומטית.
CellMergeStateCellMergeStateספירה של מצבי המיזוג השונים של תא בטבלה.
ColorTypeColorTypeספירה של סוגי צבעים.
ContentAlignmentContentAlignmentספירה של ערכים המשמשים לציון יישור התוכן.
DashStyleDashStyleאנצ'ורציה של סגנונות הקווים המקבילים השונים שיכולים להיות ל-Line.
FillTypeFillTypeספירה של סוגי מילוי.
LineCategoryLineCategoryספירה של הקטגוריות של Line.
LineFillTypeLineFillTypeספירה של סוגי LineFill.
LineTypeLineTypeספירה של סוגי Line.
LinkTypeLinkTypeספירה של סוגי הקישורים.
ListPresetListPresetספירה של סוגי ההגדרות המוגדרות מראש של רשימות.
PageBackgroundTypePageBackgroundTypeספירה של סוגי הרקעים של דפים.
PageElementTypePageElementTypeספירה של סוגי רכיבי הדף.
PageTypePageTypeספירה של סוגי הדפים.
ParagraphAlignmentParagraphAlignmentספירה של סוגי היישור של הפסקה.
PlaceholderTypePlaceholderTypeספירה של סוגי ה-placeholders.
PredefinedLayoutPredefinedLayoutספירה של הפריסות שהוגדרו מראש.
SelectionTypeSelectionTypeספירה של סוגי הבחירות.
ShapeTypeShapeTypeספירה של סוגי הצורות.
SheetsChartEmbedTypeSheetsChartEmbedTypeספירה של סוגי הטמעת התרשימים ב-Sheets.
SlideLinkingModeSlideLinkingModeפירוט הדרכים שבהן אפשר לקשר את Slides.
SlidePositionSlidePositionספירה של סוגי המיקומים של שקפים.
SpacingModeSpacingModeספירה של סוגי מצבי הריווח.
TextBaselineOffsetTextBaselineOffsetספירה של סוגי ההיסט של קו הבסיס של הטקסט.
TextDirectionTextDirectionספירה של סוגי ההוראות בטקסט.
ThemeColorTypeThemeColorTypeספירה של צבעי העיצוב.
VideoSourceTypeVideoSourceTypeספירה של סוגי מקורות הווידאו.

Methods

שיטהסוג הערך המוחזרתיאור קצר
create(name)Presentationיצירת Presentation חדש ופתיחת הקובץ.
getActivePresentation()Presentationהפונקציה מחזירה את הצגה הפעילה הנוכחית שאליה הסקריפט מקושר לקונטיינר, או את הערך null אם אין הצגה פעילה.
getUi()Uiהפונקציה מחזירה מופע של סביבת ממשק המשתמש של המצגת, שמאפשר לסקריפט להוסיף תכונות כמו תפריטים, תיבות דו-שיח וסרגלי צד.
newAffineTransformBuilder()AffineTransformBuilderהפונקציה מחזירה AffineTransformBuilder חדש כדי ליצור AffineTransform.
openById(id)Presentationפתיחת ה-Presentation עם המזהה שצוין.
openByUrl(url)Presentationפתיחת Presentation עם כתובת ה-URL שצוינה.

מסמכים מפורטים

create(name)

יצירת Presentation חדש ופתיחת הקובץ.

פרמטרים

שםסוגתיאור
nameStringהשם שיינתן למצגת שנוצרה.

חזרה

Presentation – המצגת עם השם שניתן לה.

אישור

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

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

getActivePresentation()

הפונקציה מחזירה את הצגת הפגישה הפעילה הנוכחית שאליה הסקריפט מקושר לקונטיינר, או את הערך null אם אין הצגת פגישה פעילה. כדי ליצור אינטראקציה עם מצגת שהסקריפט שלה לא קשור לקונטיינר, צריך להשתמש ב-openById(id) במקום זאת. 

// Get the current presentation to which this script is bound.
const presentation = SlidesApp.getActivePresentation();
 אם המצגת כבר פתוחה, יוחזר אותו מופע של המצגת.

חזרה

Presentation

אישור

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

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

getUi()

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

// Add a custom menu to the active presentation, including a separator and a
// sub-menu.
function onOpen(e) {
  SlidesApp.getUi()
      .createMenu('My Menu')
      .addItem('My menu item', 'myFunction')
      .addSeparator()
      .addSubMenu(
          SlidesApp.getUi()
              .createMenu('My sub-menu')
              .addItem('One sub-menu item', 'mySecondFunction')
              .addItem('Another sub-menu item', 'myThirdFunction'),
          )
      .addToUi();
}

חזרה

Ui

newAffineTransformBuilder()

הפונקציה מחזירה AffineTransformBuilder חדש כדי ליצור AffineTransform. ה-builder מוגדר מראש עם טרנספורמציית affine של הזהות.

חזרה

AffineTransformBuilder

openById(id)

פתיחת ה-Presentation עם המזהה שצוין. 

// Open a presentation by ID.
const presentation = SlidesApp.openById('docId');
 אם המצגת כבר פתוחה, יוחזר אותו מופע של המצגת.

פרמטרים

שםסוגתיאור
idString

חזרה

Presentation – המצגת עם המזהה שצוין

אישור

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

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

openByUrl(url)

פתיחת Presentation עם כתובת ה-URL שצוינה. 

// Open a presentation by URL.
const presentation = SlidesApp.openByUrl(
    'https://docs.google.com/presentation/d/docId/edit',
);
 אם המצגת כבר פתוחה, יוחזר אותו מופע של המצגת.

פרמטרים

שםסוגתיאור
urlString

חזרה

Presentation — המצגת עם כתובת ה-URL שצוינה

אישור

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

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