Google Slides
阅读、编写和创建演示文稿
Google Slides 是一个动态的基于云的演示文稿应用程序,允许用户实时创建、编辑、协作和展示幻灯片。作为 Google 生产力套件的一部分,Google Slides 提供了一个灵活的平台,用于设计引人入胜的演示文稿,与他人协作,并通过云无缝共享内容。
了解如何在 Sim 中集成 Google Slides 工具,以轻松管理作为自动化工作流程一部分的演示文稿。通过 Sim,您可以直接通过代理和自动化流程读取、编写、创建和更新 Google Slides 演示文稿,从而轻松传递最新信息、生成自定义报告或以编程方式制作品牌幻灯片。
使用 Google Slides,您可以:
- 创建和编辑演示文稿:使用主题、布局和多媒体内容设计视觉吸引力的幻灯片
- 实时协作:与团队成员同时工作,评论、分配任务并实时接收演示文稿的反馈
- 随时随地展示:在线或离线展示演示文稿,分享链接或发布到网络
- 添加图片和丰富内容:插入图片、图形、图表和视频,使您的演示文稿更具吸引力
- 与其他服务集成:与 Google Drive、Docs、Sheets 和其他第三方工具无缝连接
- 从任何设备访问:在台式机、笔记本电脑、平板电脑和移动设备上使用 Google Slides,最大限度地提高灵活性
在 Sim 中,Google Slides 集成使您的代理能够以编程方式直接与演示文稿文件交互。自动化任务如读取幻灯片内容、插入新幻灯片或图片、替换整个幻灯片中的文本、生成新演示文稿以及检索幻灯片缩略图。这使您能够扩展内容创建,保持演示文稿的最新状态,并将其嵌入到自动化文档工作流程中。通过将 Sim 与 Google Slides 连接,您可以实现 AI 驱动的演示文稿管理——轻松生成、更新或从演示文稿中提取信息,而无需手动操作。
将 Google 幻灯片集成到工作流程中。可以读取、写入、创建演示文稿,替换文本,添加幻灯片,添加图片,以及获取缩略图。
从 Google 幻灯片演示文稿中读取内容
| 参数 | 类型 | 必需 | 描述 |
|---|
presentationId | string | 是 | 要读取的演示文稿的 ID |
| 参数 | 类型 | 描述 |
|---|
slides | json | 包含内容的幻灯片数组 |
metadata | json | 包括 ID、标题和 URL 的演示文稿元数据 |
在 Google 幻灯片演示文稿中写入或更新内容
| 参数 | 类型 | 必需 | 描述 |
|---|
presentationId | string | 是 | 要写入的演示文稿的 ID |
content | string | 是 | 要写入幻灯片的内容 |
slideIndex | number | 否 | 要写入的幻灯片索引 (默认为第一张幻灯片) |
| 参数 | 类型 | 描述 |
|---|
updatedContent | boolean | 表示演示文稿内容是否成功更新 |
metadata | json | 更新后的演示文稿元数据,包括 ID、标题和 URL |
创建一个新的 Google 幻灯片演示文稿
| 参数 | 类型 | 必需 | 描述 |
|---|
title | string | 是 | 要创建的演示文稿的标题 |
content | string | 否 | 要添加到第一张幻灯片的内容 |
folderSelector | string | 否 | 选择创建演示文稿的文件夹 |
folderId | string | 否 | 用于创建演示文稿的文件夹 ID (内部使用) |
| 参数 | 类型 | 描述 |
|---|
metadata | json | 创建的演示文稿元数据,包括 ID、标题和 URL |
在 Google 幻灯片演示文稿中查找并替换所有文本
| 参数 | 类型 | 必需 | 描述 |
|---|
presentationId | string | 是 | 演示文稿的 ID |
findText | string | 是 | 要查找的文本 (例如,{{placeholder}}) |
replaceText | string | 是 | 要替换的文本 |
matchCase | boolean | 否 | 是否区分大小写 (默认值:true) |
pageObjectIds | string | 否 | 用逗号分隔的幻灯片对象 ID 列表,用于限制替换到特定幻灯片 (留空表示所有幻灯片) |
| 参数 | 类型 | 描述 |
|---|
occurrencesChanged | number | 替换的文本出现次数 |
metadata | json | 操作元数据,包括演示文稿 ID 和 URL |
向 Google 幻灯片演示文稿添加具有指定布局的新幻灯片
| 参数 | 类型 | 必需 | 描述 |
|---|
presentationId | string | 是 | 演示文稿的 ID |
layout | string | 否 | 幻灯片的预定义布局 (BLANK, TITLE, TITLE_AND_BODY, TITLE_ONLY, SECTION_HEADER 等)。默认为 BLANK。 |
insertionIndex | number | 否 | 可选的从零开始的索引,指示插入幻灯片的位置。如果未指定,则幻灯片添加到末尾。 |
placeholderIdMappings | string | 否 | JSON 数组的占位符映射,用于为占位符分配自定义对象 ID。格式:[{"layoutPlaceholder":{"type":"TITLE"},"objectId":"custom_title_id"}] |
| 参数 | 类型 | 描述 |
|---|
slideId | string | 新创建幻灯片的对象 ID |
metadata | json | 操作元数据,包括演示文稿 ID、布局和 URL |
在 Google 幻灯片演示文稿中的特定幻灯片中插入图片
| 参数 | 类型 | 必需 | 描述 |
|---|
presentationId | string | 是 | 演示文稿的 ID |
pageObjectId | string | 是 | 要添加图片的幻灯片/页面的对象 ID |
imageUrl | string | 是 | 图片的公开可访问 URL(必须是 PNG、JPEG 或 GIF,最大 50MB) |
width | number | 否 | 图片的宽度(单位:点,默认值:300) |
height | number | 否 | 图片的高度(单位:点,默认值:200) |
positionX | number | 否 | 距离左边缘的 X 位置(单位:点,默认值:100) |
positionY | number | 否 | 距离顶部边缘的 Y 位置(单位:点,默认值:100) |
| 参数 | 类型 | 描述 |
|---|
imageId | string | 新创建图片的对象 ID |
metadata | json | 操作元数据,包括演示文稿 ID 和图片 URL |
生成 Google 幻灯片演示文稿中特定幻灯片的缩略图
| 参数 | 类型 | 必需 | 描述 |
|---|
presentationId | string | 是 | 演示文稿的 ID |
pageObjectId | string | 是 | 要获取缩略图的幻灯片/页面的对象 ID |
thumbnailSize | string | 否 | 缩略图的大小:SMALL(200px)、MEDIUM(800px)或 LARGE(1600px)。默认为 MEDIUM。 |
mimeType | string | 否 | 缩略图图像的 MIME 类型:PNG 或 GIF。默认为 PNG。 |
| 参数 | 类型 | 描述 |
|---|
contentUrl | string | 缩略图图像的 URL(有效期为 30 分钟) |
width | number | 缩略图的宽度(以像素为单位) |
height | number | 缩略图的高度(以像素为单位) |
metadata | json | 操作元数据,包括演示文稿 ID 和页面对象 ID |
- 类别:
tools
- 类型:
google_slides
| 参数 | 类型 | 必需 | 描述 |
|---|
presentationId | string | 是 | Google Slides 演示文稿 ID |
pageObjectId | string | 是 | 要检索的幻灯片/页面的对象 ID |
| 参数 | 类型 | 描述 |
|---|
objectId | string | 页面对象 ID |
pageType | string | 页面类型(SLIDE、MASTER、LAYOUT、NOTES、NOTES_MASTER) |
pageElements | array | 此页面上的页面元素数组(形状、图片、表格等) |
slideProperties | object | 幻灯片特有属性(布局、母版、备注) |
↳ layoutObjectId | string | 此幻灯片所基于布局的对象 ID |
↳ masterObjectId | string | 此幻灯片所基于母版的对象 ID |
↳ notesPage | json | 与幻灯片关联的备注页 |
metadata | object | 操作元数据,包括演示文稿 ID 和 URL |
↳ presentationId | string | 演示文稿 ID |
↳ url | string | 演示文稿的 URL |
从 Google Slides 演示文稿中删除页面元素(形状、图片、表格等)或整个幻灯片
| 参数 | 类型 | 必需 | 描述 |
|---|
presentationId | string | 是 | Google Slides 演示文稿 ID |
objectId | string | 是 | 要删除的元素或幻灯片的对象 ID |
| 参数 | 类型 | 描述 |
|---|
deleted | boolean | 对象是否已成功删除 |
objectId | string | 被删除的对象 ID |
metadata | object | 操作元数据,包括演示文稿 ID 和 URL |
↳ presentationId | string | 演示文稿 ID |
↳ url | string | 演示文稿的 URL |
在 Google Slides 演示文稿中复制对象(幻灯片、形状、图片、表格等)
| 参数 | 类型 | 必需 | 描述 |
|---|
presentationId | string | 是 | Google Slides 演示文稿 ID |
objectId | string | 是 | 要复制的元素或幻灯片的对象 ID |
objectIds | string | 否 | 可选的 JSON 对象,将被复制幻灯片内的源对象 ID 映射为新对象 ID。格式:{"sourceId1":"newId1","sourceId2":"newId2"} |
| 参数 | 类型 | 描述 |
|---|
duplicatedObjectId | string | 新创建副本的对象 ID |
metadata | object | 操作元数据,包括演示文稿 ID 和源对象 ID |
↳ presentationId | string | 演示文稿 ID |
↳ sourceObjectId | string | 被复制的原始对象 ID |
↳ url | string | 演示文稿的 URL |
将一个或多个幻灯片移动到 Google Slides 演示文稿中的新位置
| 参数 | 类型 | 必需 | 描述 |
|---|
presentationId | string | 是 | Google Slides 演示文稿 ID |
slideObjectIds | string | 是 | 逗号分隔的幻灯片对象 ID 列表,幻灯片将保持相对顺序。 |
insertionIndex | number | 是 | 幻灯片应移动到的从零开始的索引,所有索引大于或等于该值的幻灯片将向右移动。 |
| 参数 | 类型 | 描述 |
|---|
moved | boolean | 幻灯片是否成功移动 |
slideObjectIds | array | 被移动的幻灯片对象 ID |
insertionIndex | number | 幻灯片被移动到的索引 |
metadata | object | 操作元数据,包括演示文稿 ID 和 URL |
↳ presentationId | string | 演示文稿 ID |
↳ url | string | 演示文稿的 URL |
在 Google Slides 演示文稿的幻灯片上创建新表格
| 参数 | 类型 | 必需 | 描述 |
|---|
presentationId | string | 是 | Google Slides 演示文稿 ID |
pageObjectId | string | 是 | 要添加表格的幻灯片/页面对象 ID |
rows | number | 是 | 表格的行数(最少 1 行) |
columns | number | 是 | 表格的列数(最少 1 列) |
width | number | 否 | 表格宽度(单位:点,默认值:400) |
height | number | 否 | 表格高度(单位:点,默认值:200) |
positionX | number | 否 | 距离左边缘的 X 位置(单位:点,默认值:100) |
positionY | number | 否 | 距离顶部边缘的 Y 位置(单位:点,默认值:100) |
| 参数 | 类型 | 描述 |
|---|
tableId | string | 新建表格的对象 ID |
rows | number | 表格的行数 |
columns | number | 表格的列数 |
metadata | object | 操作元数据,包括演示文稿 ID 和页面对象 ID |
在 Google Slides 演示文稿的幻灯片上创建形状(矩形、椭圆、文本框、箭头等)
| 参数 | 类型 | 必需 | 描述 |
|---|
presentationId | string | 是 | Google Slides 演示文稿 ID |
pageObjectId | string | 是 | 要添加形状的幻灯片/页面对象 ID |
shapeType | string | 是 | 要创建的形状类型。常见类型:TEXT_BOX、RECTANGLE、ROUND_RECTANGLE、ELLIPSE、TRIANGLE、DIAMOND、STAR_5、ARROW_EAST、HEART、CLOUD |
width | number | 否 | 形状的宽度(单位:点,默认值:200) |
height | number | 否 | 形状的高度(单位:点,默认值:100) |
positionX | number | 否 | 距离左边缘的 X 位置(单位:点,默认值:100) |
positionY | number | 否 | 距离顶部边缘的 Y 位置(单位:点,默认值:100) |
| 参数 | 类型 | 描述 |
|---|
shapeId | string | 新创建形状的对象 ID |
shapeType | string | 创建的形状类型 |
metadata | object | 操作元数据,包括演示文稿 ID 和页面对象 ID |
↳ presentationId | string | 演示文稿 ID |
↳ pageObjectId | string | 创建形状的页面对象 ID |
↳ url | string | 演示文稿的 URL |
在 Google Slides 演示文稿中的形状或表格单元格插入文本。可用于向文本框、形状或表格单元格添加文本。
| 参数 | 类型 | 必需 | 描述 |
|---|
presentationId | string | 是 | Google Slides 演示文稿 ID |
objectId | string | 是 | 要插入文本的形状或表格单元格的对象 ID。对于表格单元格,请使用单元格对象 ID。 |
text | string | 是 | 要插入的文本 |
insertionIndex | number | 否 | 插入文本的起始索引(从零开始)。如果未指定,则文本插入到开头(索引 0)。 |
| 参数 | 类型 | 描述 |
|---|
inserted | boolean | 文本是否插入成功 |
objectId | string | 插入文本的对象 ID |
text | string | 插入的文本内容 |
metadata | object | 操作元数据,包括演示文稿 ID 和 URL |
↳ presentationId | string | 演示文稿 ID |
↳ url | string | 演示文稿的 URL |