本頁面由 Cloud Translation API 翻譯而成。

Class NotesMaster

簡報中的備忘稿主控項。

筆記母片可為所有筆記頁面定義預設文字樣式和頁面元素。筆記主檔為唯讀。

方法

方法	傳回類型	簡短說明
`getGroups()`	`Group[]`	傳回頁面上的 `Group` 物件清單。
`getImages()`	`Image[]`	傳回頁面上的 `Image` 物件清單。
`getLines()`	`Line[]`	傳回頁面上的 `Line` 物件清單。
`getObjectId()`	`String`	取得網頁的專屬 ID。
`getPageElementById(id)`	`PageElement`	傳回含有指定 ID 的頁面 `PageElement`，如果不存在則傳回 `null`。
`getPageElements()`	`PageElement[]`	傳回在頁面上算繪的 `PageElement` 物件清單。
`getPlaceholder(placeholderType)`	`PageElement`	針對指定的 `PlaceholderType` 或 `null`，傳回預留位置 `PageElement` 物件 (如果沒有相符的預留位置)。
`getPlaceholder(placeholderType, placeholderIndex)`	`PageElement`	針對指定的 `PlaceholderType` 和預留位置索引，傳回預留位置 `PageElement` 物件，如果沒有預留位置，則傳回 `null`。
`getPlaceholders()`	`PageElement[]`	傳回頁面中預留位置 `PageElement` 物件的清單。
`getShapes()`	`Shape[]`	傳回頁面上的 `Shape` 物件清單。
`getSheetsCharts()`	`SheetsChart[]`	傳回頁面上的 `SheetsChart` 物件清單。
`getTables()`	`Table[]`	傳回頁面上的 `Table` 物件清單。
`getVideos()`	`Video[]`	傳回頁面上的 `Video` 物件清單。
`getWordArts()`	`WordArt[]`	傳回頁面上的 `WordArt` 物件清單。

內容詳盡的說明文件

`getGroups()`

傳回頁面上的 Group 物件清單。

回攻員

Group[]

授權

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

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

`getImages()`

傳回頁面上的 Image 物件清單。

回攻員

Image[]

授權

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

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

`getLines()`

傳回頁面上的 Line 物件清單。

回攻員

Line[]

授權

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

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

`getObjectId()`

取得網頁的專屬 ID。網頁和網頁元素使用的物件 ID 會共用相同的命名空間。

回攻員

String

授權

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

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

`getPageElementById(id)`

傳回含有指定 ID 的頁面 PageElement，如果不存在則傳回 null。

參數

名稱	類型	說明
`id`	`String`	要擷取的網頁元素 ID。

回攻員

PageElement：含有指定 ID 的頁面元素。

授權

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

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

`getPageElements()`

傳回在頁面上算繪的 PageElement 物件清單。

回攻員

PageElement[]

授權

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

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

`getPlaceholder(placeholderType)`

如果沒有相符的預留位置，則會傳回指定 PlaceholderType 或 null 的預留位置 PageElement 物件。

如果有多個同類型預留位置，則會傳回索引值最小的預留位置。如果有多個符合的預留位置具有相同的索引，則會傳回網頁元素集合的首個預留位置。

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const placeholder = slide.getPlaceholder(
    SlidesApp.PlaceholderType.CENTERED_TITLE,
);

參數

名稱	類型	說明
`placeholderType`	`PlaceholderType`

回攻員

PageElement

授權

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

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

`getPlaceholder(placeholderType, placeholderIndex)`

針對指定的 PlaceholderType 和預留位置索引，傳回預留位置 PageElement 物件，如果沒有預留位置，則傳回 null。

如果有多個預留位置的類型和索引相同，則會傳回網頁元素集合的首個預留位置。

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const placeholder = slide.getPlaceholder(
    SlidesApp.PlaceholderType.CENTERED_TITLE,
    0,
);

參數

名稱	類型	說明
`placeholderType`	`PlaceholderType`
`placeholderIndex`	`Integer`

回攻員

PageElement

授權

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

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

`getPlaceholders()`

傳回頁面中預留位置 PageElement 物件的清單。

const master = SlidesApp.getActivePresentation().getMasters()[0];
Logger.log(
    `Number of placeholders in the master: ${master.getPlaceholders().length}`,
);

回攻員

PageElement[]

授權

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

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

`getShapes()`

傳回頁面上的 Shape 物件清單。

回攻員

Shape[]

授權

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

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

`getSheetsCharts()`

傳回頁面上的 SheetsChart 物件清單。

回攻員

SheetsChart[]

授權

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

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

`getTables()`

傳回頁面上的 Table 物件清單。

回攻員

Table[]

授權

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

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

`getVideos()`

傳回頁面上的 Video 物件清單。

回攻員

Video[]

授權

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

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

`getWordArts()`

傳回頁面上的 WordArt 物件清單。

回攻員

WordArt[]

授權

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

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