您可以使用 Google Sheets API 创建、移动和删除幻灯片。本页面上的示例展示了使用 presentations.batchUpdate 方法的一些常见幻灯片操作。
这些示例使用以下变量：
- PRESENTATION_ID - 表示您提供演示文稿 ID 的位置。您可以从演示文稿网址中发现此 ID 的值。
- PAGE_ID 和 PAGE_ID2 - 指示您提供页面对象 ID 的位置。您可以从网址或使用 API 读取请求检索此 ID 的值。
这些示例以 HTTP 请求的形式呈现，与语言无关。如需了解如何使用 Google API 客户端库以不同语言实现批量更新，请参阅以下指南：创建幻灯片以及添加形状和文本。
复制幻灯片
以下 presentations.batchUpdate 代码示例展示了如何使用 DuplicateObjectRequest 方法复制幻灯片，并将其插入到演示文稿中的原始幻灯片之后。原始幻灯片由 PAGE_ID 指定。
通过该请求，您可以指定应将部分或全部页面元素 ID 包含在副本中（存在一些限制）。在本示例中，原始幻灯片包含一个表格元素（由 TABLE_ELEMENT_ID 指定），该元素已映射到幻灯片副本（由 COPY_PAGE_ID 指定）中的新表格（由 COPY_TABLE_ELEMENT_ID 指定）。副本上的所有其他元素都将获得随机 ID。
如需详细了解如何复制 PageElement（包括文本框、图片、表格、基本形状、线条和嵌入式视频），请参阅复制和修改元素示例。
以下是复制幻灯片的请求协议：
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"duplicateObject": {
"objectId": PAGE_ID,
"objectIds": {
"PAGE_ID": "COPY_PAGE_ID",
"TABLE_ELEMENT_ID": "COPY_TABLE_ELEMENT_ID"
}
}
}
]
}
制作幻灯片
以下 presentations.batchUpdate 代码示例展示了如何使用 CreateSlideRequest 方法创建幻灯片，并将其作为第四张幻灯片插入（使用从零开始的 insertionIndex）。
新幻灯片设置为使用 TITLE_AND_TWO_COLUMNS 的 PredefinedLayout。您可以指定一个字符串以用作幻灯片的 PAGE_ID（存在一些限制），也可以通过省略请求中的相应字段来允许 API 生成 PAGE_ID。
以下是制作幻灯片的请求协议：
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"createSlide": {
"objectId": "PAGE_ID",
"insertionIndex": 3,
"slideLayoutReference": {
"predefinedLayout": "TITLE_AND_TWO_COLUMNS"
}
}
}
]
}
创建幻灯片和修改占位符
以下 presentations.batchUpdate 代码示例显示了如何使用 CreateSlideRequest 方法和 TITLE_AND_TWO_COLUMNS 的 PredefinedLayout 来创建幻灯片。
您可以指定一个字符串用作幻灯片的 PAGE_ID（有一些限制）。
placeholderIdMappings 使用 TITLE 的 Type。TITLE_ID 引用了幻灯片的占位符形状，因此可以对其进行修改。
以下是制作幻灯片和修改占位符的请求协议：
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"createSlide": {
"objectId": PAGE_ID,
"slideLayoutReference": {
"predefinedLayout": "TITLE_AND_TWO_COLUMNS"
},
"placeholderIdMappings": [
{
"layoutPlaceholder": {
"type": "TITLE",
"index": 0
},
"objectId": TITLE_ID,
},
],
}
},
{
"insertText": {
"objectId": TITLE_ID,
"text": "This is my slide title",
}
},
]
}
将幻灯片移到新位置
以下 presentations.batchUpdate 代码示例展示了如何使用 UpdateSlidesPositionRequest 方法将两张指定的幻灯片移到演示文稿的开头，同时保持它们的相对顺序。
指定的幻灯片 ID（PAGE_ID 和 PAGE_ID2）必须按照现有的演示文稿顺序提供，不能出现重复项。从零开始的 insertionIndex 根据移动之前的顺序，表示幻灯片应插入的位置。该值必须介于 0 和演示文稿中的幻灯片数量之间（含 0 和 0）。
以下是将幻灯片移到新位置的请求协议：
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"updateSlidesPosition": {
"slideObjectIds": [
PAGE_ID,
PAGE_ID2
],
"insertionIndex": 0
}
}
]
}
设置幻灯片背景图片
以下 presentations.batchUpdate 代码示例展示了如何使用 UpdatePagePropertiesRequest 方法设置 PAGE_ID 指定的幻灯片的背景图片。API 使用 IMAGE_URL 检索图片。
字段掩码用于指定只应更改幻灯片背景以保留其他属性。使用字段掩码也可以提升性能。
此外，您还可以使用 UpdatePagePropertiesRequest 方法将幻灯片的背景设为纯色。
以下是设置幻灯片背景图片的请求协议：
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"updatePageProperties": {
"objectId": PAGE_ID,
"pageProperties": {
"pageBackgroundFill": {
"stretchedPictureFill": {
"contentUrl": IMAGE_URL
}
}
},
"fields": "pageBackgroundFill"
}
}
]
}
生成缩略图
您可以通过调用 presentations.pages.getThumbnail 方法为演示文稿中特定页面的最新版本生成缩略图，该方法以内容网址的形式返回页面的缩略图。图片网址的默认生命周期为 30 分钟。
您还可以指定使用 ThumbnailProperties 字段作为查询参数返回的 mimeType 和 thumbnailSize。
以下是生成设置了 ThumbnailProperties 的页面缩略图的请求协议：
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID/thumbnail?thumbnailProperties.mimeType=PNG&thumbnailProperties.thumbnailSize=MEDIUM
{
"width": 800,
"height": 450,
"contentUrl": "CONTENT_URL"
}