簡報。
方法
內容詳盡的說明文件
add Editor(emailAddress)
將指定使用者新增至 Presentation
的編輯者清單。如果使用者已在觀看者名單中,這個方法會將使用者從觀看者名單中移除。
參數
名稱 | 類型 | 說明 |
---|---|---|
email | String | 要新增的使用者電子郵件地址。 |
回攻員
Presentation
:這個 Presentation
,用於鏈結。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
add Editor(user)
將指定使用者新增至 Presentation
的編輯者清單。如果使用者已在觀看者名單中,這個方法會將使用者從觀看者名單中移除。
參數
名稱 | 類型 | 說明 |
---|---|---|
user | User | 要新增的使用者代表。 |
回攻員
Presentation
:這個 Presentation
,用於鏈結。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
add Editors(emailAddresses)
將指定的使用者陣列新增至 Presentation
的編輯者清單。如果有任何使用者已在觀眾名單中,這個方法會將他們從觀眾名單中移除。
參數
名稱 | 類型 | 說明 |
---|---|---|
email | String[] | 要新增的使用者電子郵件地址陣列。 |
回攻員
Presentation
:這個 Presentation
,用於鏈結。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
add Viewer(emailAddress)
將指定使用者新增至 Presentation
的觀眾名單。如果使用者已在編輯者名單中,這個方法就不會生效。
參數
名稱 | 類型 | 說明 |
---|---|---|
email | String | 要新增的使用者電子郵件地址。 |
回攻員
Presentation
:這個 Presentation
,用於鏈結。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
add Viewer(user)
將指定使用者新增至 Presentation
的觀眾名單。如果使用者已在編輯者名單中,這個方法就不會生效。
參數
名稱 | 類型 | 說明 |
---|---|---|
user | User | 要新增的使用者代表。 |
回攻員
Presentation
:這個 Presentation
,用於鏈結。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
add Viewers(emailAddresses)
將指定的使用者陣列新增至 Presentation
的觀眾清單。如果有任何使用者已在編輯者清單中,則此方法對他們不會有任何影響。
參數
名稱 | 類型 | 說明 |
---|---|---|
email | String[] | 要新增的使用者電子郵件地址陣列。 |
回攻員
Presentation
:這個 Presentation
,用於鏈結。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
append Slide()
使用 Predefined
預先定義的版面配置,根據目前的母片將簡報結尾附加一張投影片。目前的母片是下列其中一種:
- 目前最後一張投影片的主檔案。
- 簡報中的第一個投影片 (如果沒有投影片,則為第一個投影片)。
回攻員
Slide
:附加的新投影片。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
append Slide(layout)
append Slide(predefinedLayout)
使用指定的預先定義版面配置,根據目前的母片,在簡報結尾處附加一張投影片。目前的母片是下列其中一種:
- 目前最後一張投影片的主檔案。
- 簡報中的第一個投影片 (如果沒有投影片,則為第一個投影片)。
參數
名稱 | 類型 | 說明 |
---|---|---|
predefined | Predefined | 新投影片要使用的預先定義版面配置,應會出現在目前的母片中。 |
回攻員
Slide
:附加的新投影片。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
append Slide(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);
參數
名稱 | 類型 | 說明 |
---|---|---|
slide | Slide | 要複製及附加的投影片。 |
回攻員
Slide
:附加的新投影片。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
append Slide(slide, linkingMode)
將來源簡報中提供的 Slide
副本附加至目前簡報的結尾,並依照 Slide
指定的內容設定投影片連結。
如果要複製的投影片來自其他簡報,且父項主控和版面配置頁面尚未存在於目前的簡報中,系統也會複製這些頁面。
如果連結模式為 Slide
,系統會在呼叫 Slide.refreshSlide()
時更新附加的投影片,以便與提供的來源投影片相符。其他協作者則會看到來源投影片的連結。Slide
無法與目前簡報中的來源投影片搭配使用。
// 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, );
參數
名稱 | 類型 | 說明 |
---|---|---|
slide | Slide | 要複製、附加和連結的幻燈片。 |
linking | Slide | 要使用的連結模式。 |
回攻員
Slide
:新投影片。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Editors()
取得這個 Presentation
的編輯者清單。
回攻員
User[]
:具備編輯權限的使用者陣列。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Id()
取得簡報的專屬 ID。您可以搭配使用 Slides
和簡報 ID 開啟特定簡報例項。
回攻員
String
:這份簡報的 ID。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Layouts()
get Masters()
get Name()
取得簡報的名稱或標題。
回攻員
String
:這份簡報的標題。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Notes Master()
取得簡報的備註主控項。
回攻員
Notes
:簡報的備忘稿主檔。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Notes Page Height()
以點為單位,取得簡報中筆記主控項和筆記頁面的頁面高度。且頁面高度相同。
回攻員
Number
:以點為單位的筆記頁面高度。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Notes Page Width()
以像素為單位,取得簡報中筆記主控項和筆記頁面的頁面寬度。它們都具有相同的頁面寬度。
回攻員
Number
:以點為單位的筆記頁面寬度。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Page Element By Id(id)
傳回具有指定 ID 的 Page
,如果不存在,則傳回 null
。
參數
名稱 | 類型 | 說明 |
---|---|---|
id | String | 要擷取的網頁元素 ID。 |
回攻員
Page
:含有指定 ID 的頁面元素。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Page Height()
以點為單位,取得簡報中投影片、版面配置和母版的頁面高度。且頁面高度相同。
回攻員
Number
:頁面高度 (以點為單位)。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Page Width()
以點為單位,取得簡報中投影片、版面配置和母版的頁面寬度。它們都具有相同的頁面寬度。
回攻員
Number
:頁面寬度 (以點為單位)。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Selection()
取得使用者在有效簡報中的選取項目。指令碼只能存取執行指令碼的使用者所選取的項目,且只有在指令碼繫結至簡報時才能存取。
請注意,傳回的選項是目前有效的選項。當指令碼對簡報進行各種變更時,系統會將選取項目轉換為考量這些變更。舉例來說,如果選取了兩個圖形 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
get Slide By Id(id)
get Slides()
get Url()
擷取可存取這份簡報的網址。
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
get Viewers()
取得這個 Presentation
的檢視者和加註者清單。
回攻員
User[]
:具有查看或註解權限的使用者陣列。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Slide(insertionIndex)
根據目前的主投影片,使用 Predefined
預先定義的版面配置,在簡報中指定索引處插入投影片。目前的母片為下列其中一種:
- 上一張投影片的母片。
- 如果插入索引為零,則為第一張投影片的主檔案。
- 簡報中的第一個投影片 (如果沒有投影片,則為第一個投影片)。
參數
名稱 | 類型 | 說明 |
---|---|---|
insertion | Integer | 以零為基準的索引,指出要插入投影片的位置。 |
回攻員
Slide
:插入的新投影片。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Slide(insertionIndex, layout)
使用目前主投影片的指定版面配置,在簡報的指定索引處插入投影片。目前的母片是下列其中一種:
- 上一張投影片的母片。
- 如果插入索引為零,則為第一張投影片的主檔案。
- 簡報中的第一個投影片 (如果沒有投影片,則為第一個投影片)。
參數
名稱 | 類型 | 說明 |
---|---|---|
insertion | Integer | 以零為基準的索引,指出要插入投影片的位置。 |
layout | Layout | 新投影片要使用的版面配置,應位於目前的母片中。 |
回攻員
Slide
:插入的新投影片。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Slide(insertionIndex, predefinedLayout)
使用目前主投影片的指定預先定義版面配置,在簡報的指定索引處插入投影片。目前的母片是下列其中一種:
- 上一張投影片的母片。
- 如果插入索引為零,則為第一張投影片的主檔案。
- 簡報中的第一個投影片 (如果沒有投影片,則為第一個投影片)。
參數
名稱 | 類型 | 說明 |
---|---|---|
insertion | Integer | 以零為基準的索引,指出要插入投影片的位置。 |
predefined | Predefined | 新投影片要使用的預先定義版面配置,應會出現在目前的母片中。 |
回攻員
Slide
:插入的新投影片。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Slide(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);
參數
名稱 | 類型 | 說明 |
---|---|---|
insertion | Integer | 以零為基準的索引,指出要插入投影片的位置。 |
slide | Slide | 要複製及插入的投影片。 |
回攻員
Slide
:插入的新投影片。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Slide(insertionIndex, slide, linkingMode)
將來源簡報中提供的 Slide
副本插入目前簡報中的指定索引,並依 Slide
指定的內容設定投影片連結。
如果要複製的投影片來自其他簡報,且父項主控和版面配置頁面尚未存在於目前的簡報中,系統也會複製這些頁面。
如果連結模式為 Slide
,在呼叫 Slide.refreshSlide()
時,系統可以更新插入的投影片,以便與提供的來源投影片相符。其他協作者則會看到來源投影片的連結。Slide
無法與目前簡報中的來源投影片搭配使用。
// 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, );
參數
名稱 | 類型 | 說明 |
---|---|---|
insertion | Integer | 以零為基準的索引,指出要插入投影片的位置。 |
slide | Slide | 要複製及插入的投影片。 |
linking | Slide | 要使用的連結模式。 |
回攻員
Slide
:新投影片。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
remove Editor(emailAddress)
將指定使用者從 Presentation
的編輯者清單中移除。如果使用者屬於擁有一般存取權的使用者類別,這個方法就不會阻止他們存取 Presentation
,例如 Presentation
與使用者的整個網域共用,或是 Presentation
位於使用者可存取的共用雲端硬碟中。
對於雲端硬碟檔案,這也會將使用者從檢視者清單中移除。
參數
名稱 | 類型 | 說明 |
---|---|---|
email | String | 要移除的使用者電子郵件地址。 |
回攻員
Presentation
:這個 Presentation
,用於鏈結。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
remove Editor(user)
將指定使用者從 Presentation
的編輯者清單中移除。如果使用者屬於擁有一般存取權的使用者類別,這個方法就不會阻止他們存取 Presentation
,例如 Presentation
與使用者的整個網域共用,或是 Presentation
位於使用者可存取的共用雲端硬碟中。
對於雲端硬碟檔案,這也會將使用者從檢視者清單中移除。
參數
名稱 | 類型 | 說明 |
---|---|---|
user | User | 要移除的使用者代表。 |
回攻員
Presentation
:這個 Presentation
,用於鏈結。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
remove Viewer(emailAddress)
將指定使用者從 Presentation
的觀眾和留言者名單中移除。如果使用者是編輯者,而非觀眾或評論者,則這個方法不會生效。使用者如果屬於具有一般存取權的使用者類別,這項方法也不會阻止使用者存取 Presentation
,例如 Presentation
與使用者的整個網域共用,或是 Presentation
位於使用者可存取的共用雲端硬碟中。
對於雲端硬碟檔案,這也會將使用者從編輯者清單中移除。
參數
名稱 | 類型 | 說明 |
---|---|---|
email | String | 要移除的使用者電子郵件地址。 |
回攻員
Presentation
:用於鏈結的 Presentation
。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
remove Viewer(user)
將指定使用者從 Presentation
的觀眾和留言者名單中移除。如果使用者是編輯者而非觀眾,這個方法就不會生效。如果使用者屬於具有一般存取權的使用者類別,這項方法也不會阻止使用者存取 Presentation
,例如 Presentation
與使用者的整個網域共用,或是 Presentation
位於使用者可存取的共用雲端硬碟中。
對於雲端硬碟檔案,這也會將使用者從編輯者清單中移除。
參數
名稱 | 類型 | 說明 |
---|---|---|
user | User | 要移除的使用者代表。 |
回攻員
Presentation
:用於鏈結的 Presentation
。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace All Text(findText, replaceText)
將所有符合搜尋文字的文字,替換成替換文字。搜尋時不區分大小寫。
參數
名稱 | 類型 | 說明 |
---|---|---|
find | String | 要尋找的文字。 |
replace | String | 要取代相符文字的文字。 |
回攻員
Integer
- 重複次數變更
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace All Text(findText, replaceText, matchCase)
將所有符合搜尋文字的文字,替換成替換文字。
參數
名稱 | 類型 | 說明 |
---|---|---|
find | String | 要尋找的文字。 |
replace | String | 要取代相符文字的文字。 |
match | Boolean | 如果為 true ,搜尋會區分大小寫;如果為 false ,搜尋則不區分大小寫。 |
回攻員
Integer
- 重複次數變更
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
save And Close()
儲存目前的 Presentation
。會導致待處理的更新內容刷新並套用。
系統會在每個開放 Presentation
的指令碼執行作業結束時自動叫用 save
方法,即使指令碼執行作業因錯誤而終止也是如此。
無法編輯已關閉的 Presentation
。使用 Slides
的其中一種開啟方法,重新開啟特定簡報進行編輯。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Name(name)
設定簡報的名稱或標題。
參數
名稱 | 類型 | 說明 |
---|---|---|
name | String | 要為這份簡報設定的名稱。 |
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations