---
title: Google Slides
description: 阅读、编写和创建演示文稿
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="google_slides"
  color="#E0E0E0"
/>

{/* MANUAL-CONTENT-START:intro */}
[Google Slides](https://slides.google.com) 是一个动态的基于云的演示文稿应用程序，允许用户实时创建、编辑、协作和展示幻灯片。作为 Google 生产力套件的一部分，Google Slides 提供了一个灵活的平台，用于设计引人入胜的演示文稿，与他人协作，并通过云无缝共享内容。

了解如何在 Sim 中集成 Google Slides 工具，以轻松管理作为自动化工作流程一部分的演示文稿。通过 Sim，您可以直接通过代理和自动化流程读取、编写、创建和更新 Google Slides 演示文稿，从而轻松传递最新信息、生成自定义报告或以编程方式制作品牌幻灯片。

使用 Google Slides，您可以：

- **创建和编辑演示文稿**：使用主题、布局和多媒体内容设计视觉吸引力的幻灯片
- **实时协作**：与团队成员同时工作，评论、分配任务并实时接收演示文稿的反馈
- **随时随地展示**：在线或离线展示演示文稿，分享链接或发布到网络
- **添加图片和丰富内容**：插入图片、图形、图表和视频，使您的演示文稿更具吸引力
- **与其他服务集成**：与 Google Drive、Docs、Sheets 和其他第三方工具无缝连接
- **从任何设备访问**：在台式机、笔记本电脑、平板电脑和移动设备上使用 Google Slides，最大限度地提高灵活性

在 Sim 中，Google Slides 集成使您的代理能够以编程方式直接与演示文稿文件交互。自动化任务如读取幻灯片内容、插入新幻灯片或图片、替换整个幻灯片中的文本、生成新演示文稿以及检索幻灯片缩略图。这使您能够扩展内容创建，保持演示文稿的最新状态，并将其嵌入到自动化文档工作流程中。通过将 Sim 与 Google Slides 连接，您可以实现 AI 驱动的演示文稿管理——轻松生成、更新或从演示文稿中提取信息，而无需手动操作。
{/* MANUAL-CONTENT-END */}

## 使用说明

将 Google 幻灯片集成到工作流程中。可以读取、写入、创建演示文稿，替换文本，添加幻灯片，添加图片，以及获取缩略图。

## 工具

### `google_slides_read`

从 Google 幻灯片演示文稿中读取内容

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `presentationId` | string | 是 | 要读取的演示文稿的 ID |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `slides` | json | 包含内容的幻灯片数组 |
| `metadata` | json | 包括 ID、标题和 URL 的演示文稿元数据 |

### `google_slides_write`

在 Google 幻灯片演示文稿中写入或更新内容

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `presentationId` | string | 是 | 要写入的演示文稿的 ID |
| `content` | string | 是 | 要写入幻灯片的内容 |
| `slideIndex` | number | 否 | 要写入的幻灯片索引 \(默认为第一张幻灯片\) |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `updatedContent` | boolean | 表示演示文稿内容是否成功更新 |
| `metadata` | json | 更新后的演示文稿元数据，包括 ID、标题和 URL |

### `google_slides_create`

创建一个新的 Google 幻灯片演示文稿

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `title` | string | 是 | 要创建的演示文稿的标题 |
| `content` | string | 否 | 要添加到第一张幻灯片的内容 |
| `folderSelector` | string | 否 | 选择创建演示文稿的文件夹 |
| `folderId` | string | 否 | 用于创建演示文稿的文件夹 ID \(内部使用\) |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `metadata` | json | 创建的演示文稿元数据，包括 ID、标题和 URL |

### `google_slides_replace_all_text`

在 Google 幻灯片演示文稿中查找并替换所有文本

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `presentationId` | string | 是 | 演示文稿的 ID |
| `findText` | string | 是 | 要查找的文本 \(例如，\{\{placeholder\}\}\) |
| `replaceText` | string | 是 | 要替换的文本 |
| `matchCase` | boolean | 否 | 是否区分大小写 \(默认值：true\) |
| `pageObjectIds` | string | 否 | 用逗号分隔的幻灯片对象 ID 列表，用于限制替换到特定幻灯片 \(留空表示所有幻灯片\) |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `occurrencesChanged` | number | 替换的文本出现次数 |
| `metadata` | json | 操作元数据，包括演示文稿 ID 和 URL |

### `google_slides_add_slide`

向 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_slides_add_image`

在 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_slides_get_thumbnail`

生成 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_delete_object`

从 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_duplicate_object`

在 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_update_slides_position`

将一个或多个幻灯片移动到 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_create_table`

在 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_create_shape`

在 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_insert_text`

在 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 |
