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

屬性

屬性	類型	說明
AlignmentPosition	AlignmentPosition	對齊位置類型的列舉。
ArrowStyle	ArrowStyle	列舉 Line 可用的不同箭頭樣式。
AutoTextType	AutoTextType	自動簡訊類型的列舉。
AutofitType	AutofitType	自動調整類型的列舉。
CellMergeState	CellMergeState	列舉表格儲存格的不同合併狀態。
ColorType	ColorType	顏色類型的列舉。
ContentAlignment	ContentAlignment	列舉值，用於指定內容對齊方式。
DashStyle	DashStyle	列舉 Line 可用的不同破折號樣式。
FillType	FillType	填充類型的列舉。
LineCategory	LineCategory	列舉 Line 的類別。
LineFillType	LineFillType	列舉 LineFill 的類型。
LineType	LineType	列舉 Line 的類型。
LinkType	LinkType	列舉連結類型。
ListPreset	ListPreset	清單預設值類型的列舉。
PageBackgroundType	PageBackgroundType	列舉網頁背景類型。
PageElementType	PageElementType	列舉頁面元素的類型。
PageType	PageType	列舉網頁類型。
ParagraphAlignment	ParagraphAlignment	列舉段落對齊類型。
PlaceholderType	PlaceholderType	預留位置類型的列舉。
PredefinedLayout	PredefinedLayout	預先定義版面配置的列舉。
SelectionType	SelectionType	列舉選取項目的類型。
ShapeType	ShapeType	形狀類型的列舉。
SheetsChartEmbedType	SheetsChartEmbedType	試算表圖表嵌入類型的列舉。
SlideLinkingMode	SlideLinkingMode	列舉可連結簡報的方式。
SlidePosition	SlidePosition	幻燈片位置類型的列舉。
SpacingMode	SpacingMode	列舉間距模式類型。
TextBaselineOffset	TextBaselineOffset	列舉文字基準線偏移的類型。
TextDirection	TextDirection	列舉文字方向的類型。
ThemeColorType	ThemeColorType	主題顏色列舉。
VideoSourceType	VideoSourceType	列舉影片來源類型。

方法

方法	傳回類型	簡短說明
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。

參數

名稱	類型	說明
name	String	要為建立的簡報指定的名稱。

回攻員

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

如果簡報已開啟，系統會傳回相同的簡報例項。

參數

名稱	類型	說明
id	String

回攻員

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

如果簡報已開啟，系統會傳回相同的簡報例項。

參數

名稱	類型	說明
url	String

回攻員

Presentation：含有指定網址的簡報

授權

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

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