展示操作

您可以通过 Google Slides 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."
     
}
   
}
 
]
}