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

Class Master

簡報中的母片。

母版包含一組版面配置的所有常見頁面元素和常見屬性。這些檔案有三個用途：

母版上的預留位置形狀包含使用該母版的頁面上所有預留位置形狀的預設文字樣式和形狀屬性。
主頁面的屬性會定義其版面配置所繼承的一般頁面屬性。
主投影片中的任何其他形狀都會顯示在使用該主控件的所有投影片中，無論其版面配置為何。

方法

方法	傳回類型	簡短說明
`getBackground()`	`PageBackground`	取得網頁的背景。
`getColorScheme()`	`ColorScheme`	取得與網頁相關聯的 `ColorScheme`。
`getGroups()`	`Group[]`	傳回頁面上的 `Group` 物件清單。
`getImages()`	`Image[]`	傳回頁面上的 `Image` 物件清單。
`getLayouts()`	`Layout[]`	取得這個主控項的版面配置。
`getLines()`	`Line[]`	傳回頁面上的 `Line` 物件清單。
`getObjectId()`	`String`	取得網頁的專屬 ID。
`getPageElementById(id)`	`PageElement`	傳回含有指定 ID 的頁面 `PageElement`，如果不存在則傳回 `null`。
`getPageElements()`	`PageElement[]`	傳回在頁面上算繪的 `PageElement` 物件清單。
`getPageType()`	`PageType`	取得頁面類型。
`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` 物件清單。
`group(pageElements)`	`Group`	將所有指定的網頁元素分組。
`insertGroup(group)`	`Group`	在頁面上插入提供的 `Group` 副本。
`insertImage(blobSource)`	`Image`	在頁面左上角插入圖片，並使用指定圖片 Blob 的預設大小。
`insertImage(blobSource, left, top, width, height)`	`Image`	在頁面上插入圖片，並使用指定圖片 Blob 中提供的位置和大小。
`insertImage(image)`	`Image`	在頁面上插入提供的 `Image` 副本。
`insertImage(imageUrl)`	`Image`	在頁面左上角插入圖片，並使用提供網址的預設大小。
`insertImage(imageUrl, left, top, width, height)`	`Image`	在頁面上插入圖片，並使用提供的網址中指定的位置和大小。
`insertLine(line)`	`Line`	在頁面上插入提供的 `Line` 副本。
`insertLine(lineCategory, startConnectionSite, endConnectionSite)`	`Line`	在頁面上插入一條連結兩個 `connection sites` 的線。
`insertLine(lineCategory, startLeft, startTop, endLeft, endTop)`	`Line`	在頁面上插入一行。
`insertPageElement(pageElement)`	`PageElement`	在頁面上插入提供的 `PageElement` 副本。
`insertShape(shape)`	`Shape`	在頁面上插入提供的 `Shape` 副本。
`insertShape(shapeType)`	`Shape`	在頁面上插入圖形。
`insertShape(shapeType, left, top, width, height)`	`Shape`	在頁面上插入圖形。
`insertSheetsChart(sourceChart)`	`SheetsChart`	在頁面上插入 Google 試算表圖表。
`insertSheetsChart(sourceChart, left, top, width, height)`	`SheetsChart`	在頁面上插入 Google 試算表圖表，並使用提供的位置和大小。
`insertSheetsChart(sheetsChart)`	`SheetsChart`	在頁面上插入提供的 `SheetsChart` 副本。
`insertSheetsChartAsImage(sourceChart)`	`Image`	在頁面上插入 Google 試算表圖表，做為 `Image`。
`insertSheetsChartAsImage(sourceChart, left, top, width, height)`	`Image`	在頁面上插入 Google 試算表圖表，並以 `Image` 的形式顯示，位置和大小請參考提供的資訊。
`insertTable(numRows, numColumns)`	`Table`	在頁面上插入表格。
`insertTable(numRows, numColumns, left, top, width, height)`	`Table`	在頁面上插入表格，並使用提供的位置和大小。
`insertTable(table)`	`Table`	在頁面上插入提供的 `Table` 副本。
`insertTextBox(text)`	`Shape`	在頁面上插入文字方塊 `Shape`，其中包含所提供的字串。
`insertTextBox(text, left, top, width, height)`	`Shape`	在頁面上插入文字方塊 `Shape`，其中包含所提供的字串。
`insertVideo(videoUrl)`	`Video`	在頁面左上角插入預設大小的影片。
`insertVideo(videoUrl, left, top, width, height)`	`Video`	在頁面上插入影片，並使用指定的位置和大小。
`insertVideo(video)`	`Video`	在頁面上插入提供的 `Video` 副本。
`insertWordArt(wordArt)`	`WordArt`	在頁面上插入提供的 `WordArt` 副本。
`remove()`	`void`	移除頁面。
`replaceAllText(findText, replaceText)`	`Integer`	將所有符合搜尋文字的文字，替換成替換文字。
`replaceAllText(findText, replaceText, matchCase)`	`Integer`	將所有符合搜尋文字的文字，替換成替換文字。
`selectAsCurrentPage()`	`void`	選取目前有效簡報中的 `Page` 做為 `current page selection`，並移除先前的選取項目。

內容詳盡的說明文件

`getBackground()`

取得網頁的背景。

回攻員

PageBackground：頁面的背景。

授權

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

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

`getColorScheme()`

取得與網頁相關聯的 ColorScheme。

回攻員

ColorScheme：網頁的色彩配置。

授權

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

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

`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

`getLayouts()`

取得這個主控項的版面配置。

回攻員

Layout[]

授權

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

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

`getPageType()`

取得頁面類型。

回攻員

PageType：網頁類型。

授權

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

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

`group(pageElements)`

將所有指定的網頁元素分組。

同一個網頁中至少應有兩個未在其他群組中的網頁元素。部分網頁元素 (例如 Videos、Tables 和 placeholder Shapes) 無法加入群組。

參數

名稱	類型	說明
`pageElements`	`PageElement[]`	要分組的元素。

回攻員

Group：新群組。

授權

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

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

`insertGroup(group)`

在頁面上插入提供的 Group 副本。

插入元素在本頁的位置取決於來源元素在其對應頁面的位置。

如果提供的元素是從目前簡報中複製的預留位置，則繼承自主頁或版面配置頁面的屬性也會繼承在插入的元素上。

如果提供的元素是從其他簡報複製的預留位置，則會從來源簡報將繼承自主頁或版面配置頁面的屬性複製到元素。

// 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

`insertImage(blobSource)`

在頁面左上角插入圖片，並使用指定圖片 Blob 的預設大小。

插入圖片時，系統會從 BlobSource 擷取圖片一次，並儲存副本供簡報內顯示。圖片大小不得超過 50 MB，且解析度不得超過 2500 萬像素，格式必須為 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);

參數

名稱	類型	說明
`blobSource`	`BlobSource`	圖片資料。

回攻員

Image：已插入的圖片。

授權

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

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

`insertImage(blobSource, left, top, width, height)`

在頁面上插入圖片，並使用指定圖片 blob 提供的位置和大小。

系統會在插入時從提供的 BlobSource 擷取圖片，並儲存副本供簡報中顯示。圖片大小不得超過 50 MB，且不得超過 2,048 萬像素，格式必須為 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);

參數

名稱	類型	說明
`blobSource`	`BlobSource`	圖片資料。
`left`	`Number`	圖片的水平位置，以點為單位，從頁面左上角算起。
`top`	`Number`	圖片的垂直位置 (以點為單位)，從頁面左上角開始計算。
`width`	`Number`	圖片的寬度，以點為單位。
`height`	`Number`	圖片的高度 (以點為單位)。

回攻員

Image：已插入的圖片。

授權

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

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

`insertImage(image)`

在頁面上插入提供的 Image 副本。

插入圖片在本頁的位置，取決於來源圖片在相應網頁中的位置。

如果提供的圖片是從目前簡報中複製的預留位置，則從主頁面或版面配置頁面繼承的屬性也會繼承在插入的圖片上。

如果提供的圖片是從其他簡報複製的預留位置，則會從來源簡報將繼承自母版或版面配置頁面的屬性複製到圖片。如果複製的預留位置圖片為空白，則不會在目的地簡報中插入任何內容。

// 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

`insertImage(imageUrl)`

在頁面左上角插入圖片，並使用提供網址的預設大小。

插入圖片時，系統會從網址擷取圖片一次，並儲存副本供簡報內顯示。圖片大小不得超過 50 MB，且不得超過 2,500 萬像素，格式必須為 PNG、JPEG 或 GIF。

提供的網址必須可供所有人存取，且大小不得超過 2 KB。網址本身會與圖片一併儲存，並透過 Image.getSourceUrl() 公開。

參數

名稱	類型	說明
`imageUrl`	`String`	圖片網址。

回攻員

Image：已插入的圖片。

授權

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

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

`insertImage(imageUrl, left, top, width, height)`

使用提供的網址，在頁面上插入圖片，並套用指定的位置和大小。

插入圖片時，系統會從網址擷取圖片一次，並儲存副本供簡報內顯示。圖片大小不得超過 50 MB，且不得超過 2,500 萬像素，格式必須為 PNG、JPEG 或 GIF。

提供的網址必須可供所有人存取，且大小不得超過 2 KB。網址本身會與圖片一併儲存，並透過 Image.getSourceUrl() 公開。

為了維持圖片的顯示比例，系統會根據提供的大小縮放圖片，並將圖片置中。

參數

名稱	類型	說明
`imageUrl`	`String`	圖片網址。
`left`	`Number`	圖片的水平位置，以點為單位，從頁面左上角算起。
`top`	`Number`	圖片的垂直位置 (以點為單位)，從頁面左上角開始計算。
`width`	`Number`	圖片的寬度，以點為單位。
`height`	`Number`	圖片的高度 (以點為單位)。

回攻員

Image：已插入的圖片。

授權

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

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

`insertLine(line)`

在頁面上插入提供的 Line 副本。

插入元素在本頁的位置取決於來源元素在其對應頁面的位置。

如果提供的元素是從目前簡報中複製的預留位置，則繼承自主頁或版面配置頁面的屬性也會繼承在插入的元素上。

如果提供的元素是從其他簡報複製的預留位置，則會從來源簡報將繼承自主頁或版面配置頁面的屬性複製到元素。

// 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

`insertLine(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],
);

參數

名稱	類型	說明
`lineCategory`	`LineCategory`	要插入的線條類別。
`startConnectionSite`	`ConnectionSite`	連線點，用於連結線條的起點。
`endConnectionSite`	`ConnectionSite`	線條端點的連接點。

回攻員

Line：插入的線條。

授權

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

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

`insertLine(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,
);

參數

名稱	類型	說明
`lineCategory`	`LineCategory`	要插入的線條類別。
`startLeft`	`Number`	線條起點的水平位置，以頁面左上角為基準，以點為單位。
`startTop`	`Number`	線條起點的垂直位置，以頁面左上角為基準，以點為單位測量。
`endLeft`	`Number`	線條端點的水平位置，以頁面左上角為起點，以點為單位測量。
`endTop`	`Number`	線條終點的垂直位置，以從頁面左上角算起的點為單位。

回攻員

Line：插入的線條。

授權

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

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

`insertPageElement(pageElement)`

在頁面上插入提供的 PageElement 副本。

插入元素在本頁的位置取決於來源元素在其對應頁面的位置。

如果提供的元素是從目前簡報中複製的預留位置，則繼承自主頁或版面配置頁面的屬性也會繼承在插入的元素上。

如果提供的元素是從其他簡報複製的預留位置，則會從來源簡報將繼承自主頁或版面配置頁面的屬性複製到元素。

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

參數

名稱	類型	說明
`pageElement`	`PageElement`	要複製及插入的網頁元素。

回攻員

PageElement：插入的網頁元素。

授權

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

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

`insertShape(shape)`

在頁面上插入提供的 Shape 副本。

插入元素在本頁的位置取決於來源元素在其對應頁面的位置。

如果提供的元素是從目前簡報中複製的預留位置，則繼承自主頁或版面配置頁面的屬性也會繼承在插入的元素上。

如果提供的元素是從其他簡報複製的預留位置，則會從來源簡報將繼承自主頁或版面配置頁面的屬性複製到元素。

// 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

`insertShape(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);

參數

名稱	類型	說明
`shapeType`	`ShapeType`	要插入的形狀類型。

回攻員

Shape：插入的形狀。

授權

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

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

`insertShape(shapeType, left, top, width, height)`

在頁面上插入圖形。

參數

名稱	類型	說明
`shapeType`	`ShapeType`	要插入的形狀類型。
`left`	`Number`	形狀的水平位置，從頁面左上角開始計算。
`top`	`Number`	形狀的垂直位置，從頁面左上角開始測量。
`width`	`Number`	形狀的寬度。
`height`	`Number`	形狀的高度。

回攻員

Shape：插入的形狀。

授權

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

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

`insertSheetsChart(sourceChart)`

在頁面上插入 Google 試算表圖表。

系統會在頁面左上角插入預設大小的圖表。

插入的圖表會連結至來源 Google 試算表圖表，以便更新。其他協作者則會看到來源試算表的連結。

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

參數

名稱	類型	說明
`sourceChart`	`EmbeddedChart`	要插入頁面中的試算表圖表。

回攻員

SheetsChart：頁面中插入的圖表。

授權

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

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

`insertSheetsChart(sourceChart, left, top, width, height)`

在頁面上插入 Google 試算表圖表，並使用提供的位置和大小。

為了維持圖表的顯示比例，系統會根據提供的大小縮放圖表，並將圖表置中。

插入的圖表會連結至來源 Google 試算表圖表，以便更新。其他協作者則會看到來源試算表的連結。

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

參數

名稱	類型	說明
`sourceChart`	`EmbeddedChart`	要插入頁面中的試算表圖表。
`left`	`Number`	圖表的水平位置 (以點為單位)，從頁面左上角開始測量。
`top`	`Number`	圖表的垂直位置 (以點為單位)，從頁面左上角開始測量。
`width`	`Number`	圖表的寬度，以點為單位。
`height`	`Number`	圖表的高度 (以點為單位)。

回攻員

SheetsChart：頁面中插入的圖表。

授權

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

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

`insertSheetsChart(sheetsChart)`

在頁面上插入提供的 SheetsChart 副本。

插入元素在本頁的位置取決於來源元素在其對應頁面的位置。

如果提供的元素是從目前簡報中複製的預留位置，則繼承自主頁或版面配置頁面的屬性也會繼承在插入的元素上。

如果提供的元素是從其他簡報複製的預留位置，則會從來源簡報將繼承自主頁或版面配置頁面的屬性複製到元素。

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

參數

名稱	類型	說明
`sheetsChart`	`SheetsChart`	要複製及插入的試算表圖表。

回攻員

SheetsChart：已插入的試算表圖表。

授權

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

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

`insertSheetsChartAsImage(sourceChart)`

在頁面上插入 Google 試算表圖表，做為 Image。

圖表圖片會以預設大小插入頁面左上角。

插入的圖表圖片未連結至來源 Google 試算表圖表。

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.

參數

名稱	類型	說明
`sourceChart`	`EmbeddedChart`	要插入頁面中的試算表圖表。

回攻員

Image：插入的圖表圖片 (位於頁面中)。

授權

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

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

`insertSheetsChartAsImage(sourceChart, left, top, width, height)`

在頁面上插入 Google 試算表圖表，並以 Image 的形式顯示，位置和大小請參考提供的資訊。

為了維持圖表圖片的顯示比例，系統會根據提供的大小縮放圖片，並將圖片置中。

插入的圖表圖片未連結至來源 Google 試算表圖表。

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

參數

名稱	類型	說明
`sourceChart`	`EmbeddedChart`	要插入頁面中的試算表圖表。
`left`	`Number`	圖表的水平位置 (以點為單位)，從頁面左上角開始測量。
`top`	`Number`	圖表的垂直位置 (以點為單位)，從頁面左上角開始測量。
`width`	`Number`	圖表的寬度，以點為單位。
`height`	`Number`	圖表的高度 (以點為單位)。

回攻員

Image：插入的圖表圖片 (位於頁面中)。

授權

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

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

`insertTable(numRows, numColumns)`

在頁面上插入表格。

表格會以預設大小置中顯示在頁面上，並平均分配列和欄。

參數

名稱	類型	說明
`numRows`	`Integer`	資料表中的資料列數。
`numColumns`	`Integer`	資料表中的欄數。

回攻員

Table：已插入的表格。

授權

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

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

`insertTable(numRows, numColumns, left, top, width, height)`

在頁面上插入表格，並使用提供的位置和大小。

列和欄會平均分配至建立的表格中。

參數

名稱	類型	說明
`numRows`	`Integer`	資料表中的資料列數。
`numColumns`	`Integer`	資料表中的欄數。
`left`	`Number`	表格的水平位置，從頁面左上角開始計算。
`top`	`Number`	表格的垂直位置，從頁面左上角開始計算。
`width`	`Number`	資料表的寬度。
`height`	`Number`	表格的高度下限。實際算繪表格的高度取決於文字字型大小等因素。

回攻員

Table：已插入的表格。

授權

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

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

`insertTable(table)`

在頁面上插入提供的 Table 副本。

插入元素在本頁的位置取決於來源元素在其對應頁面的位置。

如果提供的元素是從目前簡報中複製的預留位置，則繼承自主頁或版面配置頁面的屬性也會繼承在插入的元素上。

如果提供的元素是從其他簡報複製的預留位置，則會從來源簡報將繼承自主頁或版面配置頁面的屬性複製到元素。

// 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

`insertTextBox(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

`insertTextBox(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

`insertVideo(videoUrl)`

在頁面左上角插入預設大小的影片。

目前僅支援 YouTube 影片。

參數

名稱	類型	說明
`videoUrl`	`String`	要插入的影片網址。

回攻員

Video：插入的影片。

授權

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

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

`insertVideo(videoUrl, left, top, width, height)`

在頁面上插入影片，並使用提供的位置和大小。

目前僅支援 YouTube 影片。

參數

名稱	類型	說明
`videoUrl`	`String`	要插入的影片網址。
`left`	`Number`	影片的水平位置，以點為單位，從頁面左上角起算。
`top`	`Number`	影片的垂直位置 (以點為單位)，從頁面左上角開始計算。
`width`	`Number`	影片的寬度 (以點為單位)。
`height`	`Number`	影片的高度 (以點為單位)。

回攻員

Video：插入的影片。

授權

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

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

`insertVideo(video)`

在頁面上插入提供的 Video 副本。

插入元素在本頁的位置取決於來源元素在其對應頁面的位置。

如果提供的元素是從目前簡報中複製的預留位置，則繼承自主頁或版面配置頁面的屬性也會繼承在插入的元素上。

如果提供的元素是從其他簡報複製的預留位置，則會從來源簡報將繼承自主頁或版面配置頁面的屬性複製到元素。

// 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

`insertWordArt(wordArt)`

在頁面上插入提供的 WordArt 副本。

插入元素在本頁的位置取決於來源元素在其對應頁面的位置。

如果提供的元素是從目前簡報中複製的預留位置，則繼承自主頁或版面配置頁面的屬性也會繼承在插入的元素上。

如果提供的元素是從其他簡報複製的預留位置，則會從來源簡報將繼承自主頁或版面配置頁面的屬性複製到元素。

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

參數

名稱	類型	說明
`wordArt`	`WordArt`	要複製及插入的群組。

回攻員

WordArt：插入的文字藝術。

授權

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

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

`replaceAllText(findText, replaceText)`

將所有符合搜尋文字的文字，替換成替換文字。搜尋時不區分大小寫。

參數

名稱	類型	說明
`findText`	`String`	要尋找的文字。
`replaceText`	`String`	要取代相符文字的文字。

回攻員

Integer - 重複次數變更

授權

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

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

`replaceAllText(findText, replaceText, matchCase)`

將所有符合搜尋文字的文字，替換成替換文字。

參數

名稱	類型	說明
`findText`	`String`	要尋找的文字。
`replaceText`	`String`	要取代相符文字的文字。
`matchCase`	`Boolean`	如果為 `true`，搜尋會區分大小寫；如果為 `false`，搜尋則不區分大小寫。

回攻員

Integer - 重複次數變更

授權

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

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

`selectAsCurrentPage()`

選取有效簡報中的 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