展示操作

您可以使用 Google Sheets API 创建演示文稿文件和管理现有文件。 本页面上的示例显示了使用 presentations.batchUpdate 方法。

这些示例以 HTTP 请求的形式呈现,与语言无关。学习内容 如何使用 Google API 实现不同语言的批量更新 客户端库,请参阅以下指南:

创建演示文稿

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

您还可以使用 Google Drive API 创建空白的演示文稿文件 files.create 方法(通过指定 application/vnd.google-apps.presentation 作为 MIME 类型

以下是创建演示文稿的请求协议:

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

列出现有的演示文稿文件

幻灯片 API 不提供检索 但 Drive API 支持此功能。 files.list 方法(以 使用字段掩码返回 您云端硬盘中的演示文稿文件(包括文件 ID、文件名 以及用于打开文件的链接。该请求还指定了 application/vnd.google-apps.presentation 作为 MIME type

以下是列出现有演示文稿文件的请求协议:

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.”的每个实例。替换为文本“小工具 Inc.”这包括文本框和其他形状中的文字、幻灯片上以及 大师。在这种情况下,文本替换区分大小写,具体方法是将 matchCase 发送至 true

以下是替换演示文稿中文本的请求协议:

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