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 的預留位置 PageElement 物件；或 如果沒有相符的預留位置，則傳回 null。
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從指定 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 副本。
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。

參數

名稱類型說明
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

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

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