Class Layout

版面配置

簡報中的版面配置。

每個版面配置都會成為幻燈片的範本，並由其繼承，決定這些幻燈片的內容排版和樣式。

方法

方法	傳回類型	簡短說明
getBackground()	PageBackground	取得網頁的背景。
getColorScheme()	ColorScheme	取得與網頁相關聯的 ColorScheme。
getGroups()	Group[]	傳回頁面上的 Group 物件清單。
getImages()	Image[]	傳回頁面上的 Image 物件清單。
getLayoutName()	String	取得版面配置的名稱。
getLines()	Line[]	傳回頁面上的 Line 物件清單。
getMaster()	Master	取得版面配置的基礎主版。
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

---

getLayoutName()

取得版面配置的名稱。

回攻員

String

授權

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

• 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

---

getMaster()

取得版面配置的基礎主版。

回攻員

Master

授權

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

• 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