展示操作

借助 Google 幻灯片 API，您可以创建演示文稿文件并管理现有文件。 本页面的示例展示了如何使用 the presentations.batchUpdate 方法执行一些常见的页面演示文稿操作。

这些示例以 HTTP 请求的形式呈现，以保持语言中立。如需了解如何使用 Google API 客户端库以不同语言实现批量更新，请参阅以下指南：

创建演示文稿

以下 presentations.create 代码示例展示了如何创建名为“My New Presentation”的空白演示文稿文件。

您还可以使用 Google 云端硬盘 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."
      }
    }
  ]
}