演示文稿。
方法
详细文档
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 与 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)
使用指定的预定义 ID 在演示文稿的指定索引处插入幻灯片 调整布局。当前主实例是以下之一:
- 上一张幻灯片的母版。
- 第一张幻灯片的母版(如果 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