Class Presentation

簡報

簡報。

方法

方法傳回類型簡短說明
addEditor(emailAddress)Presentation將指定使用者新增至 Presentation 的編輯者清單。
addEditor(user)Presentation將指定使用者新增至 Presentation 的編輯者清單。
addEditors(emailAddresses)Presentation將指定的使用者陣列新增至 Presentation 的編輯者清單。
addViewer(emailAddress)Presentation將指定使用者新增至 Presentation 的觀眾名單。
addViewer(user)Presentation將指定使用者新增至 Presentation 的觀眾名單。
addViewers(emailAddresses)Presentation將指定的使用者陣列新增至 Presentation 的觀眾清單。
appendSlide()Slide使用 PredefinedLayout.BLANK 預先定義的版面配置,根據目前的母片將簡報結尾附加一張投影片。
appendSlide(layout)Slide根據目前的母片,使用指定版面配置將投影片尾端附加投影片。
appendSlide(predefinedLayout)Slide根據目前的母片,使用指定的預先定義版面配置,將投影片尾端附加投影片。
appendSlide(slide)Slide將提供的 Slide 副本附加到簡報結尾。
appendSlide(slide, linkingMode)Slide將來源簡報中提供的 Slide 副本附加至目前簡報的結尾,並依照 SlideLinkingMode 指定的內容設定投影片連結。
getEditors()User[]取得這個 Presentation 的編輯者清單。
getId()String取得簡報的專屬 ID。
getLayouts()Layout[]取得簡報中的版面配置。
getMasters()Master[]取得簡報中的主投影片。
getName()String取得簡報的名稱或標題。
getNotesMaster()NotesMaster取得簡報的備註主控項。
getNotesPageHeight()Number以點為單位,取得簡報中筆記主控項和筆記頁面的頁面高度。
getNotesPageWidth()Number以點為單位,取得簡報中筆記主控項和筆記頁面的頁面寬度。
getPageElementById(id)PageElement傳回具有指定 ID 的 PageElement,如果不存在,則傳回 null
getPageHeight()Number以點為單位,取得簡報中投影片、版面配置和母版的頁面高度。
getPageWidth()Number以點為單位,取得簡報中投影片、版面配置和母片的頁面寬度。
getSelection()Selection取得使用者在有效簡報中的選取項目。
getSlideById(id)Slide傳回具有指定 ID 的 Slide,如果不存在,則傳回 null
getSlides()Slide[]取得簡報中的投影片。
getUrl()String擷取可存取這份簡報的網址。
getViewers()User[]取得這個 Presentation 的檢視者和加註者清單。
insertSlide(insertionIndex)Slide根據目前的主投影片,使用 PredefinedLayout.BLANK 預先定義的版面配置,在簡報中的指定索引處插入投影片。
insertSlide(insertionIndex, layout)Slide使用目前主投影片的指定版面配置,在簡報的指定索引處插入投影片。
insertSlide(insertionIndex, predefinedLayout)Slide使用目前主控項的指定預先定義版面配置,在簡報的指定索引處插入投影片。
insertSlide(insertionIndex, slide)Slide在簡報中指定索引處插入提供的 Slide 副本。
insertSlide(insertionIndex, slide, linkingMode)Slide將來源簡報中提供的 Slide 副本插入目前簡報中的指定索引,並依 SlideLinkingMode 指定的內容設定投影片連結。
removeEditor(emailAddress)Presentation將指定使用者從 Presentation 的編輯者清單中移除。
removeEditor(user)Presentation將指定使用者從 Presentation 的編輯者清單中移除。
removeViewer(emailAddress)Presentation將指定使用者從 Presentation 的觀眾和留言者名單中移除。
removeViewer(user)Presentation將指定使用者從 Presentation 的觀眾和留言者名單中移除。
replaceAllText(findText, replaceText)Integer將所有符合搜尋文字的文字,替換成替換文字。
replaceAllText(findText, replaceText, matchCase)Integer將所有符合搜尋文字的文字,替換成替換文字。
saveAndClose()void儲存目前的 Presentation
setName(name)void設定簡報的名稱或標題。

內容詳盡的說明文件

addEditor(emailAddress)

將指定使用者新增至 Presentation 的編輯者清單。如果使用者已在觀看者名單中,這個方法會將使用者從觀看者名單中移除。

參數

名稱類型說明
emailAddressString要新增的使用者電子郵件地址。

回攻員

Presentation:這個 Presentation,用於鏈結。

授權

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

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

addEditor(user)

將指定使用者新增至 Presentation 的編輯者清單。如果使用者已在觀看者名單中,這個方法會將使用者從觀看者名單中移除。

參數

名稱類型說明
userUser要新增的使用者代表。

回攻員

Presentation:這個 Presentation,用於鏈結。

授權

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

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

addEditors(emailAddresses)

將指定的使用者陣列新增至 Presentation 的編輯者清單。如果有任何使用者已在觀眾名單中,這個方法會將他們從觀眾名單中移除。

參數

名稱類型說明
emailAddressesString[]要新增的使用者電子郵件地址陣列。

回攻員

Presentation:這個 Presentation,用於鏈結。

授權

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

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

addViewer(emailAddress)

將指定使用者新增至 Presentation 的觀眾名單。如果使用者已在編輯者名單中,這個方法就不會生效。

參數

名稱類型說明
emailAddressString要新增的使用者電子郵件地址。

回攻員

Presentation:這個 Presentation,用於鏈結。

授權

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

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

addViewer(user)

將指定使用者新增至 Presentation 的觀眾名單。如果使用者已在編輯者名單中,這個方法就不會生效。

參數

名稱類型說明
userUser要新增的使用者代表。

回攻員

Presentation:這個 Presentation,用於鏈結。

授權

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

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

addViewers(emailAddresses)

將指定的使用者陣列新增至 Presentation 的觀眾清單。如果有任何使用者已在編輯者清單中,則此方法對他們不會有任何影響。

參數

名稱類型說明
emailAddressesString[]要新增的使用者電子郵件地址陣列。

回攻員

Presentation:這個 Presentation,用於鏈結。

授權

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

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

appendSlide()

使用 PredefinedLayout.BLANK 預先定義的版面配置,根據目前的母片將簡報結尾附加一張投影片。目前的母片是下列其中一種:

  • 目前最後一張投影片的主檔案。
  • 簡報中的第一個投影片 (如果沒有投影片,則為第一個投影片)。

回攻員

Slide:附加的新投影片。

授權

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

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

appendSlide(layout)

根據目前的母片,使用指定版面配置將投影片尾端附加投影片。目前的母片是下列其中一種:

  • 目前最後一張投影片的主檔案。
  • 簡報中的第一個投影片 (如果沒有投影片,則為第一個投影片)。

參數

名稱類型說明
layoutLayout新投影片要使用的版面配置,應位於目前的母片中。

回攻員

Slide:附加的新投影片。

授權

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

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

appendSlide(predefinedLayout)

使用指定的預先定義版面配置,根據目前的母片,在簡報結尾處附加一張投影片。目前的母片是下列其中一種:

  • 目前最後一張投影片的主檔案。
  • 簡報中的第一個投影片 (如果沒有投影片,則為第一個投影片)。

參數

名稱類型說明
predefinedLayoutPredefinedLayout新投影片要使用的預先定義版面配置,應會出現在目前的母片中。

回攻員

Slide:附加的新投影片。

授權

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

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

appendSlide(slide)

將提供的 Slide 副本附加至簡報結尾。

如果要複製的投影片來自其他簡報,且父項主控項和版面配置頁面尚未存在於此簡報中,系統也會一併複製這些項目。

// Copy a slide from another presentation and appends it.
const otherPresentation = SlidesApp.openById('presentationId');
const currentPresentation = SlidesApp.getActivePresentation();
const slide = otherPresentation.getSlides()[0];
currentPresentation.appendSlide(slide);

參數

名稱類型說明
slideSlide要複製及附加的投影片。

回攻員

Slide:附加的新投影片。

授權

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

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

appendSlide(slide, linkingMode)

將來源簡報中提供的 Slide 副本附加至目前簡報的結尾,並依照 SlideLinkingMode 指定的內容設定投影片連結。

如果要複製的投影片來自其他簡報,且父項主控和版面配置頁面尚未存在於目前的簡報中,系統也會複製這些頁面。

如果連結模式為 SlideLinkingMode.LINKED,系統會在呼叫 Slide.refreshSlide() 時更新附加的投影片,以便與提供的來源投影片相符。其他協作者則會看到來源投影片的連結。SlideLinkingMode.LINKED 無法與目前簡報中的來源投影片搭配使用。

// Copy a slide from another presentation, then append and link it.
const sourcePresentation = SlidesApp.openById('presentationId');
const currentPresentation = SlidesApp.getActivePresentation();
const slide = sourcePresentation.getSlides()[0];
const appendedSlide = currentPresentation.appendSlide(
    slide,
    SlidesApp.SlideLinkingMode.LINKED,
);

參數

名稱類型說明
slideSlide要複製、附加和連結的幻燈片。
linkingModeSlideLinkingMode要使用的連結模式。

回攻員

Slide:新投影片。

授權

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

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

getEditors()

取得這個 Presentation 的編輯者清單。

回攻員

User[]:具備編輯權限的使用者陣列。

授權

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

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

getId()

取得簡報的專屬 ID。您可以搭配使用 SlidesApp.openById() 和簡報 ID 開啟特定簡報例項。

回攻員

String:這份簡報的 ID。

授權

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

  • 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

getMasters()

取得簡報中的主投影片。

回攻員

Master[]:這份簡報中的母片清單。

授權

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

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

getName()

取得簡報的名稱或標題。

回攻員

String:這份簡報的標題。

授權

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

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

getNotesMaster()

取得簡報的備註主控項。

回攻員

NotesMaster:簡報的備忘稿主檔。

授權

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

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

getNotesPageHeight()

以點為單位,取得簡報中筆記主控項和筆記頁面的頁面高度。且頁面高度相同。

回攻員

Number:以點為單位的筆記頁面高度。

授權

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

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

getNotesPageWidth()

以像素為單位,取得簡報中筆記主控項和筆記頁面的頁面寬度。它們都具有相同的頁面寬度。

回攻員

Number:以點為單位的筆記頁面寬度。

授權

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

  • 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

getPageHeight()

以點為單位,取得簡報中投影片、版面配置和母版的頁面高度。且頁面高度相同。

回攻員

Number:頁面高度 (以點為單位)。

授權

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

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

getPageWidth()

以點為單位,取得簡報中投影片、版面配置和母版的頁面寬度。它們都具有相同的頁面寬度。

回攻員

Number:頁面寬度 (以點為單位)。

授權

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

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

getSelection()

取得使用者在有效簡報中的選取項目。指令碼只能存取執行指令碼的使用者所選取的項目,且只有在指令碼繫結至簡報時才能存取。

請注意,傳回的選項是目前有效的選項。當指令碼對簡報進行各種變更時,系統會將選取項目轉換為考量這些變更。舉例來說,如果選取了兩個圖形 A 和 B,然後指令碼移除了圖形 B,則傳回的選取項目物件會隱含更新,只選取圖形 A。

// Gets the current active page that is selected in the active presentation.
const selection = SlidesApp.getActivePresentation().getSelection();
const currentPage = selection.getCurrentPage();

回攻員

Selection:使用者選取項目的表示法,如果指令碼未繫結至呈現內容,或沒有有效的使用者選取項目,則為 null

授權

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

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

getSlideById(id)

傳回具有指定 ID 的 Slide,如果不存在,則傳回 null

參數

名稱類型說明
idString要擷取的幻燈片 ID。

回攻員

Slide:具有指定 ID 的幻燈片。

授權

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

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

getSlides()

取得簡報中的投影片。

回攻員

Slide[]:這份簡報中的投影片清單。

授權

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

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

getUrl()

擷取可存取這份簡報的網址。

const presentation = SlidesApp.getActivePresentation();

// Send out the link to open the presentation.
MailApp.sendEmail(
    '<email-address>',
    presentation.getName(),
    presentation.getUrl(),
);

回攻員

String:存取目前簡報的網址。

授權

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

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

getViewers()

取得這個 Presentation 的檢視者和加註者清單。

回攻員

User[]:具有查看或註解權限的使用者陣列。

授權

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

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

insertSlide(insertionIndex)

根據目前的主投影片,使用 PredefinedLayout.BLANK 預先定義的版面配置,在簡報中指定索引處插入投影片。目前的母片為下列其中一種:

  • 上一張投影片的母片。
  • 如果插入索引為零,則為第一張投影片的主檔案。
  • 簡報中的第一個投影片 (如果沒有投影片,則為第一個投影片)。

參數

名稱類型說明
insertionIndexInteger以零為基準的索引,指出要插入投影片的位置。

回攻員

Slide:插入的新投影片。

授權

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

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

insertSlide(insertionIndex, layout)

使用目前主投影片的指定版面配置,在簡報的指定索引處插入投影片。目前的母片是下列其中一種:

  • 上一張投影片的母片。
  • 如果插入索引為零,則為第一張投影片的主檔案。
  • 簡報中的第一個投影片 (如果沒有投影片,則為第一個投影片)。

參數

名稱類型說明
insertionIndexInteger以零為基準的索引,指出要插入投影片的位置。
layoutLayout新投影片要使用的版面配置,應位於目前的母片中。

回攻員

Slide:插入的新投影片。

授權

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

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

insertSlide(insertionIndex, predefinedLayout)

使用目前主投影片的指定預先定義版面配置,在簡報的指定索引處插入投影片。目前的母片是下列其中一種:

  • 上一張投影片的母片。
  • 如果插入索引為零,則為第一張投影片的主檔案。
  • 簡報中的第一個投影片 (如果沒有投影片,則為第一個投影片)。

參數

名稱類型說明
insertionIndexInteger以零為基準的索引,指出要插入投影片的位置。
predefinedLayoutPredefinedLayout新投影片要使用的預先定義版面配置,應會出現在目前的母片中。

回攻員

Slide:插入的新投影片。

授權

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

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

insertSlide(insertionIndex, slide)

在簡報中指定索引處插入提供的 Slide 副本。

如果要複製的投影片來自其他簡報,且父項主控項和版面配置頁面尚未存在於此簡報中,系統也會一併複製這些項目。

// Copy a slide from another presentation and inserts it.
const otherPresentation = SlidesApp.openById('presentationId');
const currentPresentation = SlidesApp.getActivePresentation();
const slide = otherPresentation.getSlides()[0];
const insertionIndex = 1;
currentPresentation.insertSlide(insertionIndex, slide);

參數

名稱類型說明
insertionIndexInteger以零為基準的索引,指出要插入投影片的位置。
slideSlide要複製及插入的投影片。

回攻員

Slide:插入的新投影片。

授權

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

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

insertSlide(insertionIndex, slide, linkingMode)

將來源簡報中提供的 Slide 副本插入目前簡報中的指定索引,並依 SlideLinkingMode 指定的內容設定投影片連結。

如果要複製的投影片來自其他簡報,且父項主控和版面配置頁面尚未存在於目前的簡報中,系統也會複製這些頁面。

如果連結模式為 SlideLinkingMode.LINKED,在呼叫 Slide.refreshSlide() 時,系統可以更新插入的投影片,以便與提供的來源投影片相符。其他協作者則會看到來源投影片的連結。SlideLinkingMode.LINKED 無法與目前簡報中的來源投影片搭配使用。

// Copy a slide from another presentation, then insert and link it.
const sourcePresentation = SlidesApp.openById('presentationId');
const currentPresentation = SlidesApp.getActivePresentation();
const slide = sourcePresentation.getSlides()[0];
const insertionIndex = 1;
const insertedSlide = currentPresentation.insertSlide(
    insertionIndex,
    slide,
    SlidesApp.SlideLinkingMode.LINKED,
);

參數

名稱類型說明
insertionIndexInteger以零為基準的索引,指出要插入投影片的位置。
slideSlide要複製及插入的投影片。
linkingModeSlideLinkingMode要使用的連結模式。

回攻員

Slide:新投影片。

授權

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

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

removeEditor(emailAddress)

將指定使用者從 Presentation 的編輯者清單中移除。如果使用者屬於擁有一般存取權的使用者類別,這個方法就不會阻止他們存取 Presentation,例如 Presentation 與使用者的整個網域共用,或是 Presentation 位於使用者可存取的共用雲端硬碟中。

對於雲端硬碟檔案,這也會將使用者從檢視者清單中移除。

參數

名稱類型說明
emailAddressString要移除的使用者電子郵件地址。

回攻員

Presentation:這個 Presentation,用於鏈結。

授權

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

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

removeEditor(user)

將指定使用者從 Presentation 的編輯者清單中移除。如果使用者屬於擁有一般存取權的使用者類別,這個方法就不會阻止他們存取 Presentation,例如 Presentation 與使用者的整個網域共用,或是 Presentation 位於使用者可存取的共用雲端硬碟中。

對於雲端硬碟檔案,這也會將使用者從檢視者清單中移除。

參數

名稱類型說明
userUser要移除的使用者代表。

回攻員

Presentation:這個 Presentation,用於鏈結。

授權

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

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

removeViewer(emailAddress)

將指定使用者從 Presentation 的觀眾和留言者名單中移除。如果使用者是編輯者,而非觀眾或評論者,則這個方法不會生效。使用者如果屬於具有一般存取權的使用者類別,這項方法也不會阻止使用者存取 Presentation,例如 Presentation 與使用者的整個網域共用,或是 Presentation 位於使用者可存取的共用雲端硬碟中。

對於雲端硬碟檔案,這也會將使用者從編輯者清單中移除。

參數

名稱類型說明
emailAddressString要移除的使用者電子郵件地址。

回攻員

Presentation:用於鏈結的 Presentation

授權

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

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

removeViewer(user)

將指定使用者從 Presentation 的觀眾和留言者名單中移除。如果使用者是編輯者而非觀眾,這個方法就不會生效。如果使用者屬於具有一般存取權的使用者類別,這項方法也不會阻止使用者存取 Presentation,例如 Presentation 與使用者的整個網域共用,或是 Presentation 位於使用者可存取的共用雲端硬碟中。

對於雲端硬碟檔案,這也會將使用者從編輯者清單中移除。

參數

名稱類型說明
userUser要移除的使用者代表。

回攻員

Presentation:用於鏈結的 Presentation

授權

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

  • 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

saveAndClose()

儲存目前的 Presentation。會導致待處理的更新內容刷新並套用。

系統會在每個開放 Presentation 的指令碼執行作業結束時自動叫用 saveAndClose() 方法,即使指令碼執行作業因錯誤而終止也是如此。

無法編輯已關閉的 Presentation。使用 SlidesApp 的其中一種開啟方法,重新開啟特定簡報進行編輯。

授權

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

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

setName(name)

設定簡報的名稱或標題。

參數

名稱類型說明
nameString要為這份簡報設定的名稱。

授權

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

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