MCP Tools Reference: slidesmcp.googleapis.com

工具：update_presentation

使用一组 batchUpdate 请求更新演示。

对应于 REST API 中的 presentations.batchUpdate。

可能的更新列表如下：

  • createSlide：创建新幻灯片。
  • createShape：创建新形状。
  • createTable：创建新表。
  • insertText：将文本插入到形状或表格单元格中。
  • insertTableRows：将行插入表中。
  • insertTableColumns：将列插入表中。
  • deleteTableRow：从表中删除一行。
  • deleteTableColumn：从表中删除列。
  • replaceAllText：替换指定文本的所有实例。
  • deleteObject：从演示中删除页面或页面元素。
  • updatePageElementTransform：更新页面元素的转换。
  • updateSlidesPosition：更新演示文稿中一组幻灯片的位置。
  • deleteText：从形状或表格单元格中删除文本。
  • createImage：创建图片。
  • createVideo：创建视频。
  • createSheetsChart：创建嵌入式 Google 表格图表。
  • createLine：创建线条。
  • refreshSheetsChart：刷新 Google 表格图表。
  • updateShapeProperties：更新形状的属性。
  • updateImageProperties：更新映像的属性。
  • updateVideoProperties：更新视频的属性。
  • updatePageProperties：更新网页的属性。
  • updateTableCellProperties：更新 TableCell 的属性。
  • updateLineProperties：更新 Line 的属性。
  • createParagraphBullets：为段落创建项目符号。
  • replaceAllShapesWithImage：将符合某些条件的所有形状替换为图片。
  • duplicateObject：复制幻灯片或页面元素。
  • updateTextStyle：更新形状或表格中文字的样式。
  • replaceAllShapesWithSheetsChart：将符合某些条件的所有形状替换为 Google 表格图表。
  • deleteParagraphBullets：从段落中删除项目符号。
  • updateParagraphStyle：更新形状或表格中段落的样式。
  • updateTableBorderProperties：更新表格中表格边框的属性。
  • updateTableColumnProperties：更新表格列的属性。
  • updateTableRowProperties：更新表格行的属性。
  • mergeTableCells：合并表格中的单元格。
  • unmergeTableCells：取消合并表格中的单元格。
  • groupObjects：用于对对象（例如页面元素）进行分组。
  • ungroupObjects：取消对象（例如群组）的分组。
  • updatePageElementAltText：更新网页元素的替代文本标题和/或说明。
  • replaceImage：将现有图片替换为新图片。
  • updateSlideProperties：更新幻灯片的属性。
  • updatePageElementsZOrder：更新页面元素的 Z 顺序。
  • importSlides：将源演示文稿中的一个或多个指定幻灯片页面导入到此（目标）演示文稿中。
  • updateLineCategory：更新某条线的类别。
  • rerouteLine：重新路由线条，使其连接到所连接页面元素上最近的两个连接点。
  • createAudio：在此演示中创建音频。
  • updateAudioProperties：更新音频的属性。

以下示例演示了如何使用 curl 调用 update_presentation MCP 工具。

Curl 请求 
curl --location 'https://slidesmcp.googleapis.com/mcp' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "update_presentation",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

输入架构

更新演示文稿的请求。

UpdatePresentationRequest

JSON 表示法 
{
  "presentationId": string,
  "requests": [
    {
      object
    }
  ]
}
字段
presentationId

string

必需。要更新的演示的 ID。
requests[]

object (Struct format)

必需。batchUpdate 请求的列表，使用 https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/request 中记录的架构和语义

结构体

JSON 表示法 
{
  "fields": {
    string: value,
    ...
  }
}
字段
fields

map (key: string, value: value (Value format))

无序的动态类型值映射。

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。

FieldsEntry

JSON 表示法 
{
  "key": string,
  "value": value
}
字段
key

string
value

value (Value format)

值

JSON 表示法 
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
字段
联合字段 kind。值的类型。kind 只能是下列其中一项：
nullValue

null

表示 JSON null。
numberValue

number

表示 JSON 数值。不得为 NaN、Infinity 或 -Infinity，因为 JSON 不支持这些值。由于 JSON 格式通常不支持其数字类型中的大型 Int64 值，因此这种格式也无法表示大型 Int64 值。
stringValue

string

表示 JSON 字符串。
boolValue

boolean

表示 JSON 布尔值（JSON 中的 true 或 false 字面量）。
structValue

object (Struct format)

表示 JSON 对象。
listValue

array (ListValue format)

表示 JSON 数组。

ListValue

JSON 表示法 
{
  "values": [
    value
  ]
}
字段
values[]

value (Value format)

动态类型值的重复字段。

NullValue

表示 JSON null。

NullValue 是一个标记，使用仅包含一个值的枚举来表示 Value 类型联合的 null 值。

如果类型为 NullValue 的字段的值不是 0，则视为无效。大多数 ProtoJSON 序列化程序都会发出一个 Value，并将 null_value 设置为 JSON null，无论整数值是多少，因此都会往返于 0 值。

枚举
NULL_VALUE Null 值。

输出架构

UpdatePresentation 响应。

UpdatePresentationResponse

JSON 表示法 
{
  "replies": [
    {
      object
    }
  ]
}
字段
replies[]

object (Struct format)

一组 batchUpdate 响应，使用 https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/response 中记录的架构和语义

结构体

JSON 表示法 
{
  "fields": {
    string: value,
    ...
  }
}
字段
fields

map (key: string, value: value (Value format))

无序的动态类型值映射。

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。

FieldsEntry

JSON 表示法 
{
  "key": string,
  "value": value
}
字段
key

string
value

value (Value format)

值

JSON 表示法 
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
字段
联合字段 kind。值的类型。kind 只能是下列其中一项：
nullValue

null

表示 JSON null。
numberValue

number

表示 JSON 数值。不得为 NaN、Infinity 或 -Infinity，因为 JSON 不支持这些值。由于 JSON 格式通常不支持其数字类型中的大型 Int64 值，因此这种格式也无法表示大型 Int64 值。
stringValue

string

表示 JSON 字符串。
boolValue

boolean

表示 JSON 布尔值（JSON 中的 true 或 false 字面量）。
structValue

object (Struct format)

表示 JSON 对象。
listValue

array (ListValue format)

表示 JSON 数组。

ListValue

JSON 表示法 
{
  "values": [
    value
  ]
}
字段
values[]

value (Value format)

动态类型值的重复字段。

NullValue

表示 JSON null。

NullValue 是一个标记，使用仅包含一个值的枚举来表示 Value 类型联合的 null 值。

如果类型为 NullValue 的字段的值不是 0，则视为无效。大多数 ProtoJSON 序列化程序都会发出一个 Value，并将 null_value 设置为 JSON null，无论整数值是多少，因此都会往返于 0 值。

枚举
NULL_VALUE Null 值。

工具注释

破坏性提示：✅ | 幂等性提示：❌ | 只读提示：❌ | 开放世界提示：✅

授权范围

需要以下 OAuth 范围之一：

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/presentations