借助 Google 幻灯片 API,您可以创建演示文稿文件并管理现有演示文稿。本页中的示例展示了使用 presentations.batchUpdate
方法执行的一些常见页面呈现操作。
这些示例以 HTTP 请求的形式呈现,不受语言限制。如需了解如何使用 Google API 客户端库以不同的语言实现批量更新,请参阅以下指南:
创建演示文稿
以下 presentations.create
代码示例展示了如何创建标题为“My New Presentation”的空白演示文稿文件。
您还可以使用 Google Drive API files.create
方法创建空白演示文稿文件,方法是将 application/vnd.google-apps.presentation
指定为 MIME 类型。
以下是创建演示文稿的请求协议:
POST https://slides.googleapis.com/v1/presentations
{ "title": "My New Presentation" }
列出现有的演示文稿文件
Slides API 不提供用于检索演示文稿列表的方法,但 Drive API 提供此方法。files.list
方法(见下文)使用字段掩码从云端硬盘返回演示文稿文件列表,其中包含文件 ID、文件名和用于打开文件的链接。该请求还将 application/vnd.google-apps.presentation
指定为 MIME 类型。
以下是用于列出现有演示文稿文件的请求协议:
GET https://www.googleapis.com/drive/v3/files?q="mimeType=application/vnd.google-apps.presentation"&fields=files(id,name,webViewLink)
此请求的响应具有以下结构:
{ "files": [ { "id": "abcdefghijklmnopqrstuvwxyz0123456789", "name": "Project Vision", "webViewLink": "https://docs.google.com/a/google.com/presentation/d/abcdefghijklmnopqrstuvwxyz0123456789/edit?usp=drivesdk" }, { "id": "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789", "name": "Untitled Presentation", "webViewLink": "https://docs.google.com/a/google.com/presentation/d/ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789/edit?usp=drivesdk" }, ... ] }
替换整个演示文稿中的文本
以下 presentations.batchUpdate
代码示例展示了如何使用 ReplaceAllTextRequest
方法替换由 PRESENTATION_ID 指定的整个演示文稿中的文本。您可以从演示文稿网址中找到演示文稿 ID 的值。
将字符串“Gizmo Corp.”的每个实例替换为文本“Gadget Inc.”这包括文本框和其他形状中的文本、幻灯片上的文本以及母版中的文本。在本例中,通过将 matchCase
设置为 true
,文本替换会区分大小写。
以下是用于替换整个演示文稿中文本的请求协议:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "replaceAllText": { "containsText": { "text": "Gizmo Corp.", "matchCase": true }, "replaceText": "Gadget Inc." } } ] }