此页面由 Cloud Translation API 翻译。

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`	获取演示的唯一标识符。
`getLayouts()`	`Layout[]`	获取演示文稿中的布局。
`getMasters()`	`Master[]`	获取演示文稿中的母版。
`getName()`	`String`	获取演示文稿的名称或标题。
`getNotesMaster()`	`NotesMaster`	获取演示文稿的备注母版。
`getNotesPageHeight()`	`Number`	获取演示文稿中备注母版和备注页面的高度（以磅为单位）。
`getNotesPageWidth()`	`Number`	获取演示文稿中备注母版和备注页面的宽度（以磅为单位）。
`getPageElementById(id)`	`PageElement\|null`	返回具有指定 ID 的 `PageElement`，如果没有，则返回 `null`。
`getPageHeight()`	`Number`	获取演示文稿中幻灯片、布局和母版的页面高度（以磅为单位）。
`getPageWidth()`	`Number`	获取演示文稿中幻灯片、布局和母版的页面宽度（以磅为单位）。
`getSelection()`	`Selection\|null`	获取活跃演示中的用户选择。
`getSlideById(id)`	`Slide\|null`	返回具有指定 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 的编辑者列表中。如果用户已在观看者列表中，此方法会将用户从观看者列表中提升出来。

参数

名称	类型	说明
`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)`

使用基于当前母版的指定布局，将幻灯片附加到演示文稿的末尾。当前主设备是以下设备之一：

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

参数

名称	类型	说明
`layout`	`Layout`	要用于新幻灯片的布局；应存在于当前母版中。

Slide - 附加的新幻灯片。

授权

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

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

`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.
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

`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,
);

参数

名称	类型	说明
`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()`

获取演示文稿中的布局。

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。

参数

名称	类型	说明
`id`	`String`	要检索的页面元素的 ID。

PageElement|null - 具有指定 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 - 用户选择的表示形式，如果脚本未绑定到演示文稿或没有有效的用户选择，则为 null。

授权

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

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

`getSlideById(id)`

返回具有指定 ID 的 Slide，如果没有，则返回 null。

参数

名称	类型	说明
`id`	`String`	要检索的幻灯片的 ID。

Slide|null - 具有指定 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 预定义布局，在演示文稿中的指定索引处插入幻灯片。当前主账号是以下账号之一：

上一个幻灯片的主控。
如果 insertionIndex 为零，则为第一个幻灯片的母版。
演示文稿中的第一个母版（如果没有幻灯片）。

参数

名称	类型	说明
`insertionIndex`	`Integer`	从零开始的索引，用于指示要插入幻灯片的位置。

Slide - 插入的新幻灯片。

授权

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

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

`insertSlide(insertionIndex, layout)`

使用基于当前母版的指定布局，在演示文稿中的指定索引处插入幻灯片。当前主设备是以下设备之一：

上一个幻灯片的主控。
如果 insertionIndex 为零，则为第一个幻灯片的母版。
演示文稿中的第一个母版（如果没有幻灯片）。

参数

名称	类型	说明
`insertionIndex`	`Integer`	从零开始的索引，用于指示要插入幻灯片的位置。
`layout`	`Layout`	要用于新幻灯片的布局；应存在于当前母版中。

Slide - 插入的新幻灯片。

授权

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

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

`insertSlide(insertionIndex, predefinedLayout)`

使用基于当前母版的指定预定义布局，在演示文稿中的指定索引处插入幻灯片。当前主设备是以下设备之一：

上一个幻灯片的主控。
如果 insertionIndex 为零，则为第一个幻灯片的母版。
演示文稿中的第一个母版（如果没有幻灯片）。

参数

名称	类型	说明
`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.
const otherPresentation = SlidesApp.openById('presentationId');
const currentPresentation = SlidesApp.getActivePresentation();
const slide = otherPresentation.getSlides()[0];
const 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.
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,
);

参数

名称	类型	说明
`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)`

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

参数

名称	类型	说明
`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。导致待处理的更新被清空并应用。

在脚本执行结束时，系统会自动为每个打开的 Presentation 调用 saveAndClose() 方法，即使脚本执行因错误而终止也是如此。

已关闭的 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

Class Presentation 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

方法

详细文档

addEditor(emailAddress)

参数

返回

授权

addEditor(user)

参数

返回

授权

addEditors(emailAddresses)

参数

返回

授权

addViewer(emailAddress)

参数

返回

授权

addViewer(user)

参数

返回

授权

addViewers(emailAddresses)

参数

返回

授权

appendSlide()

返回

授权

appendSlide(layout)

参数

返回

授权

appendSlide(predefinedLayout)

参数

返回

授权

appendSlide(slide)

参数

返回

授权

appendSlide(slide, linkingMode)

参数

返回

授权

getEditors()

返回

授权

getId()

返回

授权

getLayouts()

返回

授权

getMasters()

返回

授权

getName()

返回

授权

getNotesMaster()

返回

授权

getNotesPageHeight()

返回

授权

getNotesPageWidth()

返回

授权

getPageElementById(id)

参数

返回

授权

getPageHeight()

返回

授权

getPageWidth()

返回

授权

Class Presentation

`addEditor(emailAddress)`

`addEditor(user)`

`addEditors(emailAddresses)`

`addViewer(emailAddress)`

`addViewer(user)`

`addViewers(emailAddresses)`

`appendSlide()`

`appendSlide(layout)`

`appendSlide(predefinedLayout)`

`appendSlide(slide)`

`appendSlide(slide, linkingMode)`

`getEditors()`

`getId()`

`getLayouts()`

`getMasters()`

`getName()`

`getNotesMaster()`

`getNotesPageHeight()`

`getNotesPageWidth()`

`getPageElementById(id)`

`getPageHeight()`

`getPageWidth()`

`getSelection()`

`getSlideById(id)`

`getSlides()`

`getUrl()`

`getViewers()`

`insertSlide(insertionIndex)`

`insertSlide(insertionIndex, layout)`

`insertSlide(insertionIndex, predefinedLayout)`

`insertSlide(insertionIndex, slide)`

`insertSlide(insertionIndex, slide, linkingMode)`

`removeEditor(emailAddress)`

`removeEditor(user)`

`removeViewer(emailAddress)`

`removeViewer(user)`

`replaceAllText(findText, replaceText)`

`replaceAllText(findText, replaceText, matchCase)`

`saveAndClose()`

`setName(name)`