演示文稿操作

您可以通过 Slides API 管理现有演示文稿文件和创建新的演示文稿文件。 本页上的示例展示了一些可使用此 API 实现的常用演示文稿操作。

这些示例使用以下变量:

  • presentationId — 表示您提供演示文稿 ID 的位置。 您可以通过演示文稿网址查找此 ID 的值。
  • pageId — 表示您提供页面对象 ID 的位置。 您可以从网址或使用 API 读取请求检索此 ID 的值。
  • pageElementId — 表示您提供页面元素对象 ID 的位置。 您可以为您创建的元素指定此 ID(具有一些限制)或允许 API 自动创建一个 ID;可通过 API 读取请求检索元素 ID。

创建新演示文稿

以下 presentations.create 请求将创建一个标题为“My New Presentation”的空白演示文稿文件。 还可以使用 Drive API Files.create 方法创建空白演示文稿文件,只需将 application/vnd.google-apps.presentation 指定为 mimeType

请求协议如下所示。 创建和管理演示文稿指南展示了一个使用 Google API 客户端内容库实现不同语言批量更新的示例。

POST https://slides.googleapis.com/v1/presentations
{
  "title": "My New Presentation"
}

列出现有演示文稿文件

Slides API 不提供用于检索演示文稿列表的方法,但可使用 Drive API 轻松地进行检索。 此处介绍的 Drive API Files.list 请求使用字段掩码返回云端硬盘中演示文稿文件的列表,包括文件 ID、标题和链接。

请求协议如下所示。 Drive API 搜索文件指南展示了一个使用 Google API 客户端内容库实现不同语言文件搜索请求的示例。

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 请求在 presentationId 指定的整个演示文稿中替换文本。将字符串“Gizmo Corp.”的每个实例替换为文本“Gadget Inc.” 这包括幻灯片和母版上的文本框以及其他形状中的文本。 在此实例中,文本替换区分大小写。

请求协议如下所示。 将数据合并到幻灯片指南展示了一个使用 Google API 客户端内容库实现不同语言批量更新的示例。

POST https://slides.googleapis.com/v1/presentations/presentationId:batchUpdate
{
  "requests": [
    {
      "replaceAllText": {
          "containsText": {
            "text": "Gizmo Corp.",
            "matchCase": true
          },
          "replaceText": "Gadget Inc."
      }
    }
  ]
}

发送以下问题的反馈:

此网页
Slides API
Slides API