Class Presentation

将指定用户添加到 Presentation 的编辑者列表中。如果用户已经 ，则此方法会将该用户从查看者列表中进行升级。

参数

返回

Presentation - 此 Presentation，用于链接。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

将指定用户添加到 Presentation 的编辑者列表中。如果用户已经 ，则此方法会将该用户从查看者列表中进行升级。

参数

返回

Presentation - 此 Presentation，用于链接。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

向 Presentation 的编辑器列表添加给定的一组用户。如果存在 用户已经存在于查看者列表中，则此方法会将他们从 观看者。

参数

返回

Presentation - 此 Presentation，用于链接。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

将指定用户添加到 Presentation 的查看者列表中。如果用户已经 ，则此方法不会产生任何效果。

参数

返回

Presentation - 此 Presentation，用于链接。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

将指定用户添加到 Presentation 的查看者列表中。如果用户已经 ，则此方法不会产生任何效果。

参数

返回

Presentation - 此 Presentation，用于链接。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

将指定的一组用户添加到 Presentation 的查看者列表。如果存在 用户已经位于编辑者列表中，则此方法对他们没有影响。

参数

返回

Presentation - 此 Presentation，用于链接。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

使用 PredefinedLayout.BLANK 将幻灯片附加到演示文稿末尾 预定义的布局。当前主实例是以下之一：

• 当前最后一张幻灯片的母版。
• 演示文稿中的第一张母版（如果没有幻灯片）。

返回

Slide - 附加的新幻灯片。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

根据当前使用指定布局将幻灯片附加到演示文稿末尾 。当前主实例是以下之一：

• 当前最后一张幻灯片的母版。
• 演示文稿中的第一张母版（如果没有幻灯片）。

参数

返回

Slide - 附加的新幻灯片。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

根据预定义的预定义布局，将幻灯片附加到演示文稿末尾 当前主实例。当前主实例是以下之一：

• 当前最后一张幻灯片的母版。
• 演示文稿中的第一张母版（如果没有幻灯片）。

参数

返回

Slide - 附加的新幻灯片。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

将提供的 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 - 附加的新幻灯片。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

将提供的 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 - 新幻灯片。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

获取此 Presentation 的编辑器列表。

返回

User[] - 具有修改权限的用户数组。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

获取演示文稿的唯一标识符。演示文稿 ID 与 SlidesApp.openById() 用于打开特定演示文稿实例。

返回

String - 此演示文稿的 ID。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

获取演示文稿中的布局。

返回

Layout[] - 此演示文稿中的布局列表。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

获取演示文稿中的母版。

返回

Master[] - 此演示文稿中的母版列表。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

获取演示文稿的名称或标题。

返回

String - 此演示文稿的标题。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

获取演示文稿的备注母版。

返回

NotesMaster - 演示文稿的备注母版。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

获取演示文稿中备注母版和备注页面的页面高度（以点为单位）。他们 页面高度相同

返回

Number - 备注页面高度（以点为单位）。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

获取演示文稿中备注母版和备注页面的页面宽度（以磅为单位）。他们全都 具有相同的页面宽度。

返回

Number - 备注页面宽度（以点为单位）。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

返回具有指定 ID 的 PageElement，如果不存在，则返回 null。

参数

返回

PageElement - 具有指定 ID 的页面元素。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

获取演示文稿中幻灯片、布局和母版的页面高度（以磅为单位）。他们 它们的页面高度相同

返回

Number - 页面高度（以点为单位）。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

获取演示文稿中幻灯片、布局和母版的页面宽度（以磅为单位）。他们全都 具有相同的页面宽度。

返回

Number - 页面宽度（以点为单位）。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

获取用户在当前演示文稿中所做的选择。脚本只能访问 运行脚本的用户，且仅当该脚本绑定到演示文稿时。

请注意，返回的选择是当前的有效选择。在脚本执行期间 对演示文稿进行各种更改时，系统会转换选择内容以将这些变化考虑在内。 例如，如果选择了两个形状 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

返回具有指定 ID 的 Slide，如果不存在，则返回 null。

参数

返回

Slide - 具有指定 ID 的幻灯片。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

获取演示文稿中的幻灯片。

返回

Slide[] - 此演示文稿中的幻灯片列表。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

检索用于访问此演示文稿的网址。

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

获取此 Presentation 的查看者和评论者的列表。

返回

User[] - 具有查看或评论权限的用户数组。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

使用 PredefinedLayout.BLANK 预定义布局（基于当前母版），在演示文稿的指定索引处插入幻灯片。当前的主实例为 以下项之一：

• 上一张幻灯片的母版。
• 第一张幻灯片的母版（如果 insertIndex 为零）。
• 演示文稿中的第一张母版（如果没有幻灯片）。

参数

返回

Slide - 插入的新幻灯片。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

在演示文稿的指定索引处使用基于以下元素的指定布局插入幻灯片 当前主实例。当前主实例是以下之一：

• 上一张幻灯片的母版。
• 第一张幻灯片的母版（如果 insertIndex 为零）。
• 演示文稿中的第一张母版（如果没有幻灯片）。

参数

返回

Slide - 插入的新幻灯片。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

使用指定的预定义 ID 在演示文稿的指定索引处插入幻灯片 调整布局。当前主实例是以下之一：

• 上一张幻灯片的母版。
• 第一张幻灯片的母版（如果 insertIndex 为零）。
• 演示文稿中的第一张母版（如果没有幻灯片）。

参数

返回

Slide - 插入的新幻灯片。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

在演示文稿的指定索引处插入提供的 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);

参数

返回

Slide - 插入的新幻灯片。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

将源演示文稿中提供的 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);

参数

返回

Slide - 新幻灯片。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

从 Presentation 的编辑者列表中移除指定用户。此方法 如果用户属于符合以下条件的某个类别，则禁止该用户访问Presentation 例如，如果 Presentation 与用户的整个 网域，或者如果 Presentation 位于用户有权访问的共享云端硬盘中。

对于云端硬盘文件，此操作还会将相应用户从查看者列表中移除。

参数

返回

Presentation - 此 Presentation，用于链接。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

从 Presentation 的编辑者列表中移除指定用户。此方法 如果用户属于符合以下条件的某个类别，则禁止该用户访问Presentation 例如，如果 Presentation 与用户的整个 网域，或者如果 Presentation 位于用户有权访问的共享云端硬盘中。

对于云端硬盘文件，此操作还会将相应用户从查看者列表中移除。

参数

返回

Presentation - 此 Presentation，用于链接。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

从 Presentation 的查看者和评论者列表中移除指定用户。这个 方法则不起作用。此方法还会 如果用户属于Presentation 具有常规访问权限，例如，如果 Presentation 与用户的 也可以指定 Presentation 在用户可以访问的共享云端硬盘中。

对于云端硬盘文件，此操作也会将用户从编辑者列表中移除。

参数

返回

Presentation - 此 Presentation，用于链接。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

从 Presentation 的查看者和评论者列表中移除指定用户。这个 方法则不起作用。此方法也不会阻止 如果用户属于对具有常规性访问权限的某一类用户，则他们无法访问 Presentation。 访问权限 - 例如，如果 Presentation 与用户的整个网域共享，或者 如果Presentation位于用户可以访问的共享云端硬盘中。

对于云端硬盘文件，此操作也会将用户从编辑者列表中移除。

参数

返回

Presentation - 此 Presentation，用于链接。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

使用替换文本替换与查找文本匹配的所有文本实例。搜索是大小写 。

参数

返回

Integer - 更改的次数

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

使用替换文本替换与查找文本匹配的所有文本实例。

参数

返回

Integer - 更改的次数

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

保存当前的 Presentation。会导致刷新并应用待处理的更新。

脚本执行结束时会自动调用 saveAndClose() 方法 即使脚本执行因错误而终止，也是如此。Presentation

无法修改已关闭的Presentation。对 SlidesApp 使用其中一种打开方法，即可重新打开给定的演示文稿以供编辑。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

设置演示文稿的名称或标题。

参数

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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