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 的預留位置 PageElement 物件；或 如果沒有相符的預留位置，則傳回 null。
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從指定 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在網頁上以 Image 格式插入 Google 試算表圖表。
insertSheetsChartAsImage(sourceChart, left, top, width, height)Image使用指定位置，以 Image 形式在頁面中插入 Google 試算表圖表， 大小
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。

參數

名稱類型說明
idString要擷取的網頁元素 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 的預留位置 PageElement 物件；或 如果沒有相符的預留位置，則傳回 null。

如果有多個相同類型的預留位置，則會傳回最小的 預留位置索引。如果多個相符的預留位置使用相同索引，則會傳回 網頁元素集中的第一個預留位置。 

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

參數

名稱類型說明
placeholderTypePlaceholderType

回攻員

PageElement

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

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

getPlaceholder(placeholderType, placeholderIndex)

傳回指定 PlaceholderType 的預留位置 PageElement 物件， 預留位置索引；如果沒有預留位置，則設為 null。

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

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

參數

名稱類型說明
placeholderTypePlaceholderType
placeholderIndexInteger

回攻員

PageElement

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

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

getPlaceholders()

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

var 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 的投影片，才會有來源 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) 分組。

參數

名稱類型說明
pageElementsPageElement[]可分組的元素。

回攻員

Group：新群組。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

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

insertGroup(group)

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

系統會根據來源元素的 並在各自的頁面上放置。

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

如果提供的元素是從其他簡報複製的預留位置， 系統會將從主要頁面或版面配置頁面沿用的屬性複製到來源中的元素 簡報 

// Copy a group between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var group = otherPresentationSlide.getGroups()[0];
currentPresentationSlide.insertGroup(group); // Also available for Layout, Master, and Page.

參數

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

回攻員

Group：插入的群組。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

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

insertImage(blobSource)

在頁面左上角插入圖片，採用指定預設大小 圖片 blob。

插入圖片後，系統會從 BlobSource 擷取圖片一次，並儲存副本用於 在簡報內顯示圖片大小不得超過 50 MB，且不得超過 25 ，且必須使用 PNG、JPEG 或 GIF 格式。 

var slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
var image = DriveApp.getFileById(fileId);
slide.insertImage(image);

參數

名稱類型說明
blobSourceBlobSource圖片資料。

回攻員

Image：插入的圖片。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

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

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

從指定 image blob 的網頁中插入圖片，並提供位置與大小。

插入時，系統會從提供的BlobSource中擷取圖片一次，並建立副本 會在簡報中展示圖片大小不得超過 50 MB，不得 超過 2500 萬像素，且格式必須為 PNG、JPEG 或 GIF。

為了維持圖片的顯示比例，圖片會隨時間縮放並置中 所提供的大小。 

var slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
var image = DriveApp.getFileById(fileId);
var position = {left: 0, top: 0};
var size = {width: 300, height: 100};
slide.insertImage(image, position.left, position.top, size.width, size.height);

參數

名稱類型說明
blobSourceBlobSource圖片資料。
leftNumber圖片的水平位置 (以點為單位，從左上角測量) 網頁。
topNumber圖片的垂直位置 (以點表示，從左上角測量到 該網頁。
widthNumber圖片的寬度 (以點表示)。
heightNumber圖片的高度 (以點為單位)。

回攻員

Image：插入的圖片。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

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

insertImage(image)

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

這些插入圖片在這個網頁上的位置取決於來源圖片的位置 。

如果提供的圖片是目前簡報內複製的預留位置， 繼承主頁或版面配置頁面的屬性，也會沿用所插入的圖片。

如果提供的圖片是從其他簡報複製的預留位置， 系統會將從主要頁面或版面配置頁面沿用的屬性複製到圖片來源 簡報如果複製的預留位置圖片空白，系統就不會在目的地中插入任何項目 簡報 

// Copy an image between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var image = otherPresentationSlide.getImages[0];
currentPresentationSlide.insertImage(image);

參數

名稱類型說明
imageImage要複製及插入的圖片。

回攻員

Image：插入的圖片。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

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

insertImage(imageUrl)

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

插入圖片後，系統會從網址擷取圖片，並將副本儲存成 簡報圖片大小不得超過 50 MB、不得超過 2500 萬像素，且大小不可超過 PNG、JPEG 或 GIF 格式

提供的網址必須可公開存取，且大小不得超過 2 KB。已儲存網址本身 方法是使用映像檔並透過 Image.getSourceUrl() 公開。

參數

名稱類型說明
imageUrlString圖片網址。

回攻員

Image：插入的圖片。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

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

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

根據提供的網址插入位置與大小，在網頁上插入圖片。

插入圖片後，系統會從網址擷取圖片，並將副本儲存成 簡報圖片大小不得超過 50 MB、不得超過 2500 萬像素，且大小不可超過 PNG、JPEG 或 GIF 格式

提供的網址必須可公開存取，且大小不得超過 2 KB。已儲存網址本身 方法是使用映像檔並透過 Image.getSourceUrl() 公開。

為了維持圖片的顯示比例，圖片會隨時間縮放並置中 所提供的大小。

參數

名稱類型說明
imageUrlString圖片網址。
leftNumber圖片的水平位置 (以點為單位，從左上角測量) 網頁。
topNumber圖片的垂直位置 (以點表示，從左上角測量到 該網頁。
widthNumber圖片的寬度 (以點表示)。
heightNumber圖片的高度 (以點為單位)。

回攻員

Image：插入的圖片。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

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

insertLine(line)

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

系統會根據來源元素的 並在各自的頁面上放置。

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

如果提供的元素是從其他簡報複製的預留位置， 系統會將從主要頁面或版面配置頁面沿用的屬性複製到來源中的元素 簡報 

// Copy a line between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var line = otherPresentationSlide.getLines[0];
currentPresentationSlide.insertLine(line);

參數

名稱類型說明
lineLine要複製及插入的程式碼行。

回攻員

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.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var shape1 = slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
var shape2 = slide.insertShape(SlidesApp.ShapeType.CLOUD);
slide.insertLine(
    SlidesApp.LineCategory.BENT,
    shape1.getConnectionSites()[0],
    shape2.getConnectionSites()[1]);

參數

名稱類型說明
lineCategoryLineCategory要插入的線條類別。
startConnectionSiteConnectionSite連接線起點的連接網站。
endConnectionSiteConnectionSite連接線末端的連接網站。

回攻員

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.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var startPoint = {left: 10, top: 10};
var endPoint = {left: 40, top: 40};
slide.insertLine(
    SlidesApp.LineCategory.STRAIGHT,
    startPoint.left,
    startPoint.top,
    endPoint.left,
    endPoint.top);

參數

名稱類型說明
lineCategoryLineCategory要插入的線條類別。
startLeftNumber線條起點的水平位置 (以點為單位) 。
startTopNumber線條起點的垂直位置，從
endLeftNumber線條終點的水平位置，從
endTopNumber線條終點的垂直位置 (以從

回攻員

Line：插入的行。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

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

insertPageElement(pageElement)

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

系統會根據來源元素的 並在各自的頁面上放置。

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

如果提供的元素是從其他簡報複製的預留位置， 系統會將從主要頁面或版面配置頁面沿用的屬性複製到來源中的元素 簡報 

// Copy a page element between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var pageElement = otherPresentationSlide.getPageElements()[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertPageElement(pageElement);

參數

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

回攻員

PageElement：插入的頁面元素。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

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

insertShape(shape)

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

系統會根據來源元素的 並在各自的頁面上放置。

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

如果提供的元素是從其他簡報複製的預留位置， 系統會將從主要頁面或版面配置頁面沿用的屬性複製到來源中的元素 簡報 

// Copy a shape between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var shape = otherPresentationSlide.getShapes[0];
currentPresentationSlide.insertShape(shape); // Also available for Layout, Master, and Page.

參數

名稱類型說明
shapeShape要複製及插入的形狀。

回攻員

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.
var slide = SlidesApp.getActivePresentation().getSlides()[0];

// Also available for Layout, Master, and Page.
slide.insertShape(SlidesApp.ShapeType.RECTANGLE);

參數

名稱類型說明
shapeTypeShapeType要插入的形狀類型。

回攻員

Shape：插入的形狀。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

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

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

在頁面上插入圖案。

參數

名稱類型說明
shapeTypeShapeType要插入的形狀類型。
leftNumber形狀的水平位置 (從 頁面。
topNumber形狀的垂直位置 (從頁面左上角開始計算)。
widthNumber形狀的寬度。
heightNumber形狀的高度。

回攻員

Shape：插入的形狀。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

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

insertSheetsChart(sourceChart)

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

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

插入的圖表會與來源 Google 試算表圖表建立連結 已更新。其他協作者可以查看來源試算表的連結。 

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertSheetsChart(chart);

參數

名稱類型說明
sourceChartEmbeddedChart要插入頁面的圖表。

回攻員

SheetsChart：頁面中插入的圖表。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

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

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

在頁面上插入 Google 試算表圖表 (提供位置和大小)。

為了維持圖表的顯示比例，圖表會以尊重的比例縮放並置中 所提供的大小。

插入的圖表會與來源 Google 試算表圖表建立連結 已更新。其他協作者可以查看來源試算表的連結。 

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var position = {left: 0, top: 0};
var size = {width: 200, height: 200};

// Also available for Layout, Master, and Page.
slide.insertSheetsChart(
    chart,
    position.left,
    position.top,
    size.width,
    size.height);

參數

名稱類型說明
sourceChartEmbeddedChart要插入頁面的圖表。
leftNumber從左上角測量的圖表水平位置 網頁。
topNumber圖表的垂直位置 (以點表示，從 該網頁。
widthNumber圖表的寬度 (以點表示)。
heightNumber圖表的高度 (以點表示)。

回攻員

SheetsChart：頁面中插入的圖表。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

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

insertSheetsChart(sheetsChart)

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

系統會根據來源元素的 並在各自的頁面上放置。

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

如果提供的元素是從其他簡報複製的預留位置， 系統會將從主要頁面或版面配置頁面沿用的屬性複製到來源中的元素 簡報 

// Copy a sheets chart between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var sheetsChart = otherPresentationSlide.getSheetsCharts[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertSheetsChart(sheetsChart);

參數

名稱類型說明
sheetsChartSheetsChart要複製及插入的工作表圖表。

回攻員

SheetsChart：插入的工作表圖表。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

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

insertSheetsChartAsImage(sourceChart)

在網頁上以 Image 格式插入 Google 試算表圖表。

系統會在頁面左上角插入圖表圖片，並以預設大小顯示。

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

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertSheetsChartAsImage(chart); // Also available for Layout, Master, and Page.

參數

名稱類型說明
sourceChartEmbeddedChart要插入頁面的圖表。

回攻員

Image：頁面中插入的圖表圖片。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

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

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

使用指定位置，以 Image 形式在頁面中插入 Google 試算表圖表， 大小

為了維持圖表圖片的長寬比，系統會將圖片縮放為 會根據提供的大小進行調整

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

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var position = {left: 0, top: 0};
var size = {width: 200, height: 200};

// Also available for Layout, Master, and Page.
slide.insertSheetsChartAsImage(
    chart,
    position.left,
    position.right,
    size.width,
    size.height);

參數

名稱類型說明
sourceChartEmbeddedChart要插入頁面的圖表。
leftNumber從左上角測量的圖表水平位置 網頁。
topNumber圖表的垂直位置 (以點表示，從 該網頁。
widthNumber圖表的寬度 (以點表示)。
heightNumber圖表的高度 (以點表示)。

回攻員

Image：頁面中插入的圖表圖片。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

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

insertTable(numRows, numColumns)

在網頁上插入表格。

表格位於頁面中央，顯示預設大小，且會平均分配列和欄。

參數

名稱類型說明
numRowsInteger資料表中的資料列數。
numColumnsInteger資料表中的資料欄數。

回攻員

Table：插入的資料表。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

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

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

在網頁上插入表格 (提供位置和大小)。

列和欄會平均分配在已建立的資料表中。

參數

名稱類型說明
numRowsInteger資料表中的資料列數。
numColumnsInteger資料表中的資料欄數。
leftNumber從表格左上角測量到的水平位置 頁面。
topNumber表格的垂直位置 (從頁面左上角開始計算)。
widthNumber表格的寬度。
heightNumber表格的最小高度。實際顯示的表格實際高度取決於 也會影響文字字型大小等因素

回攻員

Table：插入的資料表。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

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

insertTable(table)

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

系統會根據來源元素的 並在各自的頁面上放置。

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

如果提供的元素是從其他簡報複製的預留位置， 系統會將從主要頁面或版面配置頁面沿用的屬性複製到來源中的元素 簡報 

// Copy a table between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var table = otherPresentationSlide.getTables[0];
currentPresentationSlide.insertTable(table); // Also available for Layout, Master, and Page.

參數

名稱類型說明
tableTable要複製及插入的資料表。

回攻員

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.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertTextBox('Hello'); // Also available for Layout, Master, and Page.

參數

名稱類型說明
textString文字方塊形狀應包含的字串。

回攻員

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.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertTextBox('Hello', 0, 0, 10, 10); // Also available for Layout, Master, and Page.

參數

名稱類型說明
textString文字方塊形狀應包含的字串。
leftNumber從左上角測量為文字方塊圖形的水平位置 網頁。
topNumber從文字方塊左上角測量到的垂直位置 該網頁。
widthNumber文字方塊形狀的寬度。
heightNumber文字方塊形狀的高度。

回攻員

Shape：插入的文字方塊形狀。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

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

insertVideo(videoUrl)

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

目前僅支援 YouTube 影片。

參數

名稱類型說明
videoUrlString要插入的影片網址。

回攻員

Video：插入的影片。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

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

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

在網頁上插入影片已提供位置和大小。

目前僅支援 YouTube 影片。

參數

名稱類型說明
videoUrlString要插入的影片網址。
leftNumber影片的水平位置，從左上角測量 網頁。
topNumber影片的垂直位置，從 該網頁。
widthNumber影片的寬度。
heightNumber影片的高度。

回攻員

Video：插入的影片。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

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

insertVideo(video)

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

系統會根據來源元素的 並在各自的頁面上放置。

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

如果提供的元素是從其他簡報複製的預留位置， 系統會將從主要頁面或版面配置頁面沿用的屬性複製到來源中的元素 簡報 

// Copy a video between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var video = otherPresentationSlide.getVideos[0];
currentPresentationSlide.insertVideo(video); // Also available for Layout, Master, and Page.

參數

名稱類型說明
videoVideo要複製並插入的影片。

回攻員

Video：插入的影片。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

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

insertWordArt(wordArt)

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

系統會根據來源元素的 並在各自的頁面上放置。

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

如果提供的元素是從其他簡報複製的預留位置， 系統會將從主要頁面或版面配置頁面沿用的屬性複製到來源中的元素 簡報 

// Copy a word art between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var wordArt = otherPresentationSlide.getWordArts[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertWordArt(wordArt);

參數

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

回攻員

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)

將投影片移至指定的索引。

參數

名稱類型說明
indexInteger根據投影片排列位置，應放置投影片的索引 。索引應介於 0 至 0 的投影片數量之間 多元包容的精神

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

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

refreshSlide()

重新整理投影片，反映對連結來源投影片所做的任何變更。如果這張投影片 未連結，返回時則不做任何變更。

refreshSlide 方法會複製連結來源投影片的對應主投影片和 即可將版面配置頁面移至投影片簡報中。如果他們已經 也會同時更新以反映來源的任何變更。 

var currentPresentation = SlidesApp.getActivePresentation();
var sourcePresentation = SlidesApp.openById('sourcePresentationId');
var sourceSlide = sourcePresentation.getSlides()[0];
var 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)

以取代文字取代所有符合尋找文字的執行個體。搜尋是案件 不區分大小寫

參數

名稱類型說明
findTextString要尋找的文字。
replaceTextString要取代相符文字的文字。

回攻員

Integer：發生變更的次數

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

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

replaceAllText(findText, replaceText, matchCase)

以取代文字取代所有符合尋找文字的執行個體。

參數

名稱類型說明
findTextString要尋找的文字。
replaceTextString要取代相符文字的文字。
matchCaseBoolean如果是 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.
var 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)

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

參數

名稱類型說明
isSkippedBooleanTrue，即可在簡報模式略過投影片。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

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

將目前的Slide與來源投影片取消連結。如果未連結這張投影片，會傳回以下結果： 不必進行任何變更 

var currentPresentation = SlidesApp.getActivePresentation();
var sourcePresentation = SlidesApp.openById('sourcePresentationId');
var sourceSlide = sourcePresentation.getSlides()[0];
var 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