简介

借助 Google Sheets API,您可以创建和修改 Google 幻灯片演示文稿。

应用可与 Google 幻灯片 API 集成,创建精美的幻灯片组 自动从用户提供的数据和系统提供的数据中获取。例如,你可以 使用数据库中的客户详细信息,并将这些详细信息与预先设计好的客户详细信息相结合, 模板和选定的配置选项,用于创建完成的演示文稿 所花的时间要短于手动创建它们。

API 概览

演示文稿集合提供 方法,用于获取和更新演示文稿中的元素。

您使用 Slides API 的大部分工作可能就是创建和更新 演示文稿。为此,您需要使用 batchUpdate 方法; 此方法会获取 请求 对象,可让您执行以下操作:

  • 创建幻灯片
  • 在幻灯片中添加元素,例如形状或表格
  • 插入、更改和移除文本
  • 对元素应用转换
  • 更改幻灯片的顺序

如需了解详情,请参阅批量更新。查看入门指南 通过一个简单的端到端示例,了解如何使用该 API。

演示文稿的结构

幻灯片 API 中的演示文稿由多个页面组成,其中包含页面 元素。

可以根据以下网址获得演示文稿的 ID:

https://docs.google.com/presentation/d/presentationId/edit

演示文稿 ID 是一个包含字母、数字和 字符。以下正则表达式可用于提取 来自 Google 表格网址的演示文稿 ID:

/presentation/d/([a-zA-Z0-9-_]+)

如果您熟悉 Drive API,就会发现 presentationId 对应于 文件的 ID 资源。

页面和页面元素通过对象 ID 进行标识。

Pages

Google 幻灯片有以下几种页面:

硕士 幻灯片母版定义默认的文本样式、背景和页面 使用此母版的所有幻灯片中显示的元素。网页 所有幻灯片中必须显示的元素都应添加到母版中。大多数人 演示文稿只有一个母版,但有些母版可能有多个母版或没有母版。
布局 布局可作为模板,用来指示用户如何排列 使用布局创建幻灯片的默认视图。每个布局都与一个 。
幻灯片 这些页面包含您向受众群体展示的内容。 大多数幻灯片都基于母版和布局。您可以指定 幻灯片布局。
备注 这些页面包含演示文稿讲义内容,其中包括 一个包含幻灯片演讲者备注的形状。每张幻灯片都有一个 相应的备注页面只能将演讲者备注形状中的文字 使用幻灯片 API 进行修改。
备注母版 备注母版为所有模板定义默认文本样式和页面元素 备注页面。备注母版在幻灯片 API 中是只读的。

页面元素

页面元素是放置在页面上的视觉组件。API 显示多种页面元素:

群组 一组被视为单个单元的页面元素。他们可以 可以一起移动、缩放和旋转
形状 一种普通的可视对象,例如矩形、椭圆形和文本框。 形状可以包含文本,因此它们是最常构建的页面元素 幻灯片。
映像 导入幻灯片的图形。
视频 导入幻灯片的视频。
折线图 可视的线条、曲线或连接符。
内容网格。
WordArt 一种行为更像形状的视觉文本元素。
SheetsChart 从 Google 表格导入幻灯片的图表。

批量更新

batchUpdate 方法 可让您更新演示文稿的许多方面。更改归入一组 一个批次,以便在一个请求失败时不执行其他请求(有可能相关) 更改已写入。

batchUpdate 方法的工作原理是接受一个或多个 请求 对象,每个对象都指定一种要执行的请求。还有 许多不同类型的请求下面详细介绍一下请求类型 可分为不同类别

使用 Google 幻灯片: CreateSlideRequest
UpdateSlidesPositionRequest
DuplicateObjectRequest
UpdatePagePropertiesRequest
DeleteObjectRequest
使用页面元素: CreateShapeRequest
CreateLineRequest
UpdatePageElementTransformRequest
UpdateShapePropertiesRequest
DuplicateObjectRequest
DeleteObjectRequest
使用表: CreateTableRequest
InsertTableRowsRequest
InsertTableColumnsRequest
DeleteTableRowRequest
DeleteTableColumnRequest
UpdateTableRowPropertiesRequest
UpdateTableColumnPropertiesRequest
UpdateTableBorderPropertiesRequest
UpdateTableCellPropertiesRequest
MergeTableCellsRequest
UnmergeTableCellsRequest
DeleteObjectRequest
使用图表: CreateSheetsChartRequest
RefreshSheetsChartRequest
ReplaceAllShapesWithSheetsChartRequest
DeleteObjectRequest
处理图片和视频: CreateImageRequest
CreateVideoRequest
UpdateImagePropertiesRequest
UpdateVideoPropertiesRequest
ReplaceAllShapesWithImageRequest
DuplicateObjectRequest
DeleteObjectRequest
处理文本: InsertTextRequest
DeleteTextRequest
ReplaceAllTextRequest
CreateParagraphBulletsRequest
DeleteParagraphBulletsRequest
UpdateTextStyleRequest
UpdateParagraphStyleRequest

batchUpdate 方法会返回响应正文, 其中包含 响应 。每个响应与对应的 请求;对于无适用响应的请求,该索引处的响应 将为空。通常,各种 Create 请求都有响应, 您知道新添加对象的 ID。

使用对象 ID

幻灯片 API 中的演示文稿由页面和页面元素组成。 这些对象包含对象 ID 字符串,此字符串在 演示文稿。

在创建时指定对象 ID

使用 batchUpdate 方法后, 可以选择为新对象指定对象 ID这样,您就可以 对象并在同一 batchUpdate 请求中进行修改,从而最大限度地减少 并减少配额使用量

在大多数情况下,我们建议生成随机对象 ID。例如,如果您 使用的是 Java,java.util.UUID.randomUUID().toString() 应该能正常运行。

当您的应用想要在较长时间内跟踪对象 请勿依赖对象 ID,因为它可能会发生变化。请参阅以下内容 部分。

在不使用对象 ID 的情况下跟踪对象

当您发出幻灯片 API 请求时,通常会保留对象 ID。(不限 异常的注释会在该方法的参考文档中列出。)制作 使用 Drive API 为整个演示文稿创建副本也会保留对象 ID。

但是,演示后不能依赖于未更改的对象 ID 在幻灯片界面中有所更改。例如,如果用户使用 Google 幻灯片 界面:复制并粘贴页面元素,然后删除原始页面元素 现在将具有新的唯一 ID,以及您之前通过 API 提供的 ID 都会丢失。因此,我们不建议您将对象 ID 存储在 应用存储空间您应按照以下做法,在演示文稿中查找对象: 文本内容或替代文本。

新创建的演示文稿通常会默认使用一组统一的 ID 幻灯片、母版和文本框。这些 ID 可能会随时间而变化 因此,我们不建议您依赖该功能而是查找 您想使用通过对 create()get().