簡報。
方法
內容詳盡的說明文件
addEditor(emailAddress)
將特定使用者新增至 Presentation
的編輯者清單。如果使用者已
觀眾也會成為觀眾,因此能在觀影迷清單中向他們宣傳。
參數
名稱 | 類型 | 說明 |
---|---|---|
emailAddress | String | 要新增的使用者電子郵件地址。 |
回攻員
Presentation
- 這個 Presentation
用於鏈結。
授權
使用這個方法的指令碼需要下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
addEditor(user)
將特定使用者新增至 Presentation
的編輯者清單。如果使用者已
觀眾也會成為觀眾,因此能在觀影迷清單中向他們宣傳。
參數
名稱 | 類型 | 說明 |
---|---|---|
user | User | 代表要新增的使用者。 |
回攻員
Presentation
- 這個 Presentation
用於鏈結。
授權
使用這個方法的指令碼需要下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
addEditors(emailAddresses)
將指定的使用者陣列新增至 Presentation
的編輯者清單。如果有任何
觀看清單中的使用者,這種做法是將他們
觀眾。
參數
名稱 | 類型 | 說明 |
---|---|---|
emailAddresses | String[] | 要新增的使用者電子郵件地址陣列。 |
回攻員
Presentation
- 這個 Presentation
用於鏈結。
授權
使用這個方法的指令碼需要下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
addViewer(emailAddress)
將特定使用者新增至 Presentation
的檢視者清單。如果使用者已
在編輯器清單上,這個方法不會有任何作用。
參數
名稱 | 類型 | 說明 |
---|---|---|
emailAddress | String | 要新增的使用者電子郵件地址。 |
回攻員
Presentation
- 這個 Presentation
用於鏈結。
授權
使用這個方法的指令碼需要下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
addViewer(user)
將特定使用者新增至 Presentation
的檢視者清單。如果使用者已
在編輯器清單上,這個方法不會有任何作用。
參數
名稱 | 類型 | 說明 |
---|---|---|
user | User | 代表要新增的使用者。 |
回攻員
Presentation
- 這個 Presentation
用於鏈結。
授權
使用這個方法的指令碼需要下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
addViewers(emailAddresses)
將指定的使用者陣列新增至 Presentation
的檢視者清單。如果有任何
使用者已在編輯者清單中,這個方法對他們沒有作用。
參數
名稱 | 類型 | 說明 |
---|---|---|
emailAddresses | String[] | 要新增的使用者電子郵件地址陣列。 |
回攻員
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)
appendSlide(predefinedLayout)
根據 目前的主要執行個體目前的主要執行個體為下列其中一個:
- 目前投影片的主投影片。
- 簡報中的第一個主投影片 (如果沒有投影片)。
參數
名稱 | 類型 | 說明 |
---|---|---|
predefinedLayout | PredefinedLayout | 新投影片要使用的預先定義版面配置;應該要有 目前的主要執行個體 |
回攻員
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. var otherPresentation = SlidesApp.openById('presentationId'); var currentPresentation = SlidesApp.getActivePresentation(); var slide = otherPresentation.getSlides()[0]; currentPresentation.appendSlide(slide);
參數
名稱 | 類型 | 說明 |
---|---|---|
slide | Slide | 要複製及附加的投影片。 |
回攻員
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. var sourcePresentation = SlidesApp.openById('presentationId'); var currentPresentation = SlidesApp.getActivePresentation(); var slide = sourcePresentation.getSlides()[0]; var appendedSlide = currentPresentation.appendSlide(slide, SlidesApp.SlideLinkingMode.LINKED);
參數
名稱 | 類型 | 說明 |
---|---|---|
slide | Slide | 要複製、附加及連結的投影片。 |
linkingMode | SlideLinkingMode | 要使用的連結模式。 |
回攻員
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。簡報 ID 會用於 SlidesApp.openById()
以開啟特定的簡報執行個體。
回攻員
String
:這份簡報的 ID。
授權
使用這個方法的指令碼需要下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLayouts()
getMasters()
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
。
參數
名稱 | 類型 | 說明 |
---|---|---|
id | String | 要擷取的網頁元素 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. var selection = SlidesApp.getActivePresentation().getSelection(); var currentPage = selection.getCurrentPage();
回攻員
Selection
— 以表示使用者選取的內容;如果指令碼未繫結,則為 null
還是無法選取有效的使用者選項
授權
使用這個方法的指令碼需要下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getSlideById(id)
getSlides()
getUrl()
擷取此簡報存取的網址。
var 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
預先定義的版面配置 (根據目前主投影片),在簡報中的指定索引插入投影片。目前的主要執行個體為
下列其中一項:
- 上一張投影片的主投影片。
- 如果 insertIndex 為零,則為第一張投影片主投影片。
- 簡報中的第一個主投影片 (如果沒有投影片)。
參數
名稱 | 類型 | 說明 |
---|---|---|
insertionIndex | Integer | 從零開始的索引,指出投影片插入位置。 |
回攻員
Slide
- 插入的新投影片。
授權
使用這個方法的指令碼需要下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSlide(insertionIndex, layout)
使用指定的版面配置,在簡報中的指定索引插入投影片 目前的主要執行個體目前的主要執行個體為下列其中一個:
- 上一張投影片的主投影片。
- 如果 insertIndex 為零,則為第一張投影片主投影片。
- 簡報中的第一個主投影片 (如果沒有投影片)。
參數
名稱 | 類型 | 說明 |
---|---|---|
insertionIndex | Integer | 從零開始的索引,指出投影片插入位置。 |
layout | Layout | 新投影片的版面配置;而應存在於目前的主要執行個體中。 |
回攻員
Slide
- 插入的新投影片。
授權
使用這個方法的指令碼需要下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSlide(insertionIndex, predefinedLayout)
使用指定的預先定義值,在簡報中的指定索引插入投影片 產生不同的版面配置目前的主要執行個體為下列其中一個:
- 上一張投影片的主投影片。
- 如果 insertIndex 為零,則為第一張投影片主投影片。
- 簡報中的第一個主投影片 (如果沒有投影片)。
參數
名稱 | 類型 | 說明 |
---|---|---|
insertionIndex | Integer | 從零開始的索引,指出投影片插入位置。 |
predefinedLayout | PredefinedLayout | 新投影片要使用的預先定義版面配置;應該要有 目前的主要執行個體 |
回攻員
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. var otherPresentation = SlidesApp.openById('presentationId'); var currentPresentation = SlidesApp.getActivePresentation(); var slide = otherPresentation.getSlides()[0]; var insertionIndex = 1; currentPresentation.insertSlide(insertionIndex, slide);
參數
名稱 | 類型 | 說明 |
---|---|---|
insertionIndex | Integer | 從零開始的索引,指出投影片插入位置。 |
slide | Slide | 要複製及插入的投影片。 |
回攻員
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. var sourcePresentation = SlidesApp.openById('presentationId'); var currentPresentation = SlidesApp.getActivePresentation(); var slide = sourcePresentation.getSlides()[0]; var insertionIndex = 1; var insertedSlide = currentPresentation.insertSlide( insertionIndex, slide, SlidesApp.SlideLinkingMode.LINKED);
參數
名稱 | 類型 | 說明 |
---|---|---|
insertionIndex | Integer | 從零開始的索引,指出投影片插入位置。 |
slide | Slide | 要複製及插入的投影片。 |
linkingMode | SlideLinkingMode | 要使用的連結模式。 |
回攻員
Slide
:新的投影片。
授權
使用這個方法的指令碼需要下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
removeEditor(emailAddress)
將特定使用者從 Presentation
的編輯者清單中移除。這個方法
如果使用者所屬的類別含有以下使用者類別,則禁止使用者存取 Presentation
一般存取權,例如 Presentation
已與整個使用者共用
網域,或是 Presentation
位於使用者可以存取的共用雲端硬碟中。
針對雲端硬碟檔案,這麼做也會將使用者從檢視者清單中移除。
參數
名稱 | 類型 | 說明 |
---|---|---|
emailAddress | String | 要移除的使用者電子郵件地址。 |
回攻員
Presentation
- 這個 Presentation
用於鏈結。
授權
使用這個方法的指令碼需要下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
removeEditor(user)
將特定使用者從 Presentation
的編輯者清單中移除。這個方法
如果使用者所屬的類別含有以下使用者類別,則禁止使用者存取 Presentation
一般存取權,例如 Presentation
已與整個使用者共用
網域,或是 Presentation
位於使用者可以存取的共用雲端硬碟中。
針對雲端硬碟檔案,這麼做也會將使用者從檢視者清單中移除。
參數
名稱 | 類型 | 說明 |
---|---|---|
user | User | 要移除的使用者表示法。 |
回攻員
Presentation
- 這個 Presentation
用於鏈結。
授權
使用這個方法的指令碼需要下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
removeViewer(emailAddress)
將特定使用者從 Presentation
的檢視者和加註者清單中移除。這個
如果使用者是編輯者,而不是檢視者或加註者,此方法不會生效。這個方法
無法禁止隸屬於特定類別的使用者存取 Presentation
但具備一般存取權,例如將 Presentation
與使用者的
或是使用者可以存取的共用雲端硬碟中,就刪除 Presentation
。
針對雲端硬碟檔案,這麼做也會將使用者從編輯者清單中移除。
參數
名稱 | 類型 | 說明 |
---|---|---|
emailAddress | String | 要移除的使用者電子郵件地址。 |
回攻員
Presentation
:這個 Presentation
用於鏈結。
授權
使用這個方法的指令碼需要下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
removeViewer(user)
將特定使用者從 Presentation
的檢視者和加註者清單中移除。這個
如果使用者是編輯者,而不是檢視者,此方法不會有任何作用。這個方法也不會
如果使用者屬於一般使用者的類別,就無法存取 Presentation
存取權,例如 Presentation
已與整個網域共用
如果 Presentation
位於使用者有權存取的共用雲端硬碟中。
針對雲端硬碟檔案,這麼做也會將使用者從編輯者清單中移除。
參數
名稱 | 類型 | 說明 |
---|---|---|
user | User | 要移除的使用者表示法。 |
回攻員
Presentation
:這個 Presentation
用於鏈結。
授權
使用這個方法的指令碼需要下列一或多個範圍的授權:
-
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
saveAndClose()
儲存目前的 Presentation
。導致系統清除及套用待處理的更新。
指令碼執行結束時,會自動叫用 saveAndClose()
方法
狀態值,Presentation
。
無法編輯已關閉的Presentation
。使用 SlidesApp
的其中一個開啟方法重新開啟指定簡報以供編輯。
授權
使用這個方法的指令碼需要下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setName(name)
設定簡報的名稱或標題。
參數
名稱 | 類型 | 說明 |
---|---|---|
name | String | 為這份簡報設定的名稱。 |
授權
使用這個方法的指令碼需要下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations