Class SlidesApp

Google 簡報應用程式

建立並開啟可編輯的 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預留位置類型的列舉。
PredefinedLayoutPredefinedLayout預先定義版面配置的列舉。
SelectionTypeSelectionType列舉選取項目的類型。
ShapeTypeShapeType形狀類型的列舉。
SheetsChartEmbedTypeSheetsChartEmbedType試算表圖表嵌入類型的列舉。
SlideLinkingModeSlideLinkingMode列舉可連結簡報的方式。
SlidePositionSlidePosition幻燈片位置類型的列舉。
SpacingModeSpacingMode列舉間距模式類型。
TextBaselineOffsetTextBaselineOffset列舉文字基準線偏移的類型。
TextDirectionTextDirection列舉文字方向的類型。
ThemeColorTypeThemeColorType主題顏色列舉。
VideoSourceTypeVideoSourceType列舉影片來源類型。

方法

方法傳回類型簡短說明
create(name)Presentation建立並開啟新的 Presentation。
getActivePresentation()Presentation傳回目前有效的呈現方式，指令碼會與容器繫結，如果沒有有效的呈現方式，則傳回 null。
getUi()Ui傳回簡報的使用者介面環境例項，讓指令碼可新增選單、對話方塊和側邊欄等功能。
newAffineTransformBuilder()AffineTransformBuilder傳回新的 AffineTransformBuilder 來建構 AffineTransform。
openById(id)Presentation開啟具有指定 ID 的 Presentation。
openByUrl(url)Presentation使用指定網址開啟 Presentation。

內容詳盡的說明文件

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

傳回簡報的使用者介面環境例項，讓指令碼可新增選單、對話方塊和側邊欄等功能。指令碼只能與目前開啟的簡報例項的 UI 互動，且只有在指令碼繫結至簡報時才能如此。詳情請參閱選單和對話方塊和側欄指南。

// 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。建構工具會預先設定為使用同構轉換。

回攻員

AffineTransformBuilder

openById(id)

開啟具有指定 ID 的 Presentation。

// Open a presentation by ID.
const presentation = SlidesApp.openById('docId');
 如果簡報已開啟，系統會傳回相同的簡報例項。

參數

名稱類型說明
idString

回攻員

Presentation：具有指定 ID 的簡報

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

openByUrl(url)

使用指定網址開啟 Presentation。

// Open a presentation by URL.
const presentation = SlidesApp.openByUrl(
    'https://docs.google.com/presentation/d/docId/edit',
);
 如果簡報已開啟，系統會傳回相同的簡報例項。

參數

名稱類型說明
urlString

回攻員

Presentation：含有指定網址的簡報

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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