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

Class Slide

簡報中的投影片。

這些網頁包含你要向觀眾呈現的內容。大多數投影片都是以母片和版面配置為基礎。您可以在建立時，指定每個投影片要使用的版面配置。

方法

方法	傳回類型	簡短說明
`duplicate()`	`Slide`	複製投影片。
`getBackground()`	`PageBackground`	取得網頁的背景。
`getColorScheme()`	`ColorScheme`	取得與網頁相關聯的 `ColorScheme`。
`getGroups()`	`Group[]`	傳回頁面上的 `Group` 物件清單。
`getImages()`	`Image[]`	傳回頁面上的 `Image` 物件清單。
`getLayout()`	`Layout`	取得投影片所依據的版面配置，如果投影片不是以版面配置為依據，則會取得 `null`。
`getLines()`	`Line[]`	傳回頁面上的 `Line` 物件清單。
`getNotesPage()`	`NotesPage`	傳回與投影片相關聯的筆記頁面。
`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` 物件清單。
`getSlideLinkingMode()`	`SlideLinkingMode`	傳回 `SlideLinkingMode`，指出投影片是否已連結至其他投影片。
`getSourcePresentationId()`	`String`	如果投影片未連結，則會傳回來源 `Presentation` ID 或 `null`。
`getSourceSlideObjectId()`	`String`	傳回來源投影片 ID，如果投影片未連結，則傳回 `null`。
`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` 副本。
`isSkipped()`	`Boolean`	傳回簡報模式中是否略過投影片。
`move(index)`	`void`	將投影片移至指定索引。
`refreshSlide()`	`void`	重新整理投影片，反映連結來源投影片的任何變更。
`remove()`	`void`	移除頁面。
`replaceAllText(findText, replaceText)`	`Integer`	將所有符合搜尋文字的文字，替換成替換文字。
`replaceAllText(findText, replaceText, matchCase)`	`Integer`	將所有符合搜尋文字的文字，替換成替換文字。
`selectAsCurrentPage()`	`void`	選取目前呈現的 `Page` 做為 `current page selection`，並移除先前的選取項目。
`setSkipped(isSkipped)`	`void`	設定簡報模式是否略過投影片。
`unlink()`	`void`	將目前的 `Slide` 與來源投影片取消連結。

內容詳盡的說明文件

`duplicate()`

複製投影片。

系統會立即在原始投影片後建立重複投影片。

回攻員

Slide：複製的投影片。

授權

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

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

`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

`getLayout()`

取得投影片所依據的版面配置，如果投影片不是以版面配置為依據，則會取得 null。

回攻員

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

`getNotesPage()`

傳回與投影片相關聯的筆記頁面。

回攻員

NotesPage

授權

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

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

`getSlideLinkingMode()`

傳回 SlideLinkingMode，指出投影片是否已連結至其他投影片。

回攻員

SlideLinkingMode：投影片連結模式。

授權

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

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

`getSourcePresentationId()`

如果投影片未連結，就會傳回來源 Presentation ID 或 null。

只有在連結至其他簡報中的投影片時，投影片才會有來源 Presentation ID。

回攻員

String：來源呈現 ID 或 null。

授權

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

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

`getSourceSlideObjectId()`

傳回來源投影片 ID，如果投影片未連結，則傳回 null。

只有在投影片連結至其他簡報中的投影片時，才會有來源投影片 ID。

回攻員

String：來源投影片 ID 或 null。

授權

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

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

`isSkipped()`

傳回簡報模式中是否略過投影片。

回攻員

Boolean：如果簡報模式略過投影片，則為 True。

授權

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

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

`move(index)`

將投影片移至指定索引。

參數

名稱	類型	說明
`index`	`Integer`	根據移動前的投影片排列方式，所要移動投影片的索引。索引值應介於零和簡報中的投影片數之間 (含兩者)。

授權

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

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

`refreshSlide()`

重新整理投影片，以反映對已連結來源投影片所做的任何變更。如果未連結此投影片，則會在未進行任何變更的情況下傳回。

如果來源投影片已連結，且對應的母片和版面配置頁面尚未存在，refreshSlide 方法會將這些頁面複製到投影片的簡報中。如果已存在這些檔案，系統也會更新這些檔案，反映來源檔案的任何變更。

const currentPresentation = SlidesApp.getActivePresentation();
const sourcePresentation = SlidesApp.openById('sourcePresentationId');
const sourceSlide = sourcePresentation.getSlides()[0];
const linkedSlide = currentPresentation.append(
    sourceSlide,
    SlidesApp.SlideLinkingMode.LINKED,
);

sourceSlide.insertText(
    'hello world');  // Only the source slide has the text box.

linkedSlide.refreshSlide();  // The linked slide now has the text box.

擲回

Error：如果無法再存取來源簡報的讀取權限。

授權

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

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

`setSkipped(isSkipped)`

設定簡報模式是否略過投影片。

參數

名稱	類型	說明
`isSkipped`	`Boolean`	`True` 可在簡報模式中略過投影片。

授權

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

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

`unlink()`

將目前的 Slide 與來源投影片取消連結。如果這個投影片未連結，則會在未做出任何變更的情況下傳回。

const currentPresentation = SlidesApp.getActivePresentation();
const sourcePresentation = SlidesApp.openById('sourcePresentationId');
const sourceSlide = sourcePresentation.getSlides()[0];
const linkedSlide = currentPresentation.append(
    sourceSlide,
    SlidesApp.SlideLinkingMode.LINKED,
);

linkedSlide.unlink();

linkedSlide.getSourcePresentationId();  // returns null
linkedSlide.getSourceSlideObjectId();   // returns null
linkedSlide
    .getSlideLinkingMode();  // returns SlidesApp.SlideLinkingMode.NOT_LINKED

授權

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

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