Sheet 表格操作参考文档

本文件包含腾讯文档 MCP 中 Sheet（在线表格）相关工具的完整 API 说明、详细调用示例、参数说明和返回值说明。

---

通用说明

Sheet 工具概述

Sheet 工具专门用于操作腾讯文档中的在线表格（Excel格式），提供表格信息的查询、范围数据的获取以及批量更新等功能。

响应结构

所有 API 返回都包含：

• error: 错误信息（成功时为空）
• trace_id: 调用链追踪 ID

工具调用示例

OperationSheet

功能说明

进行表格编辑操作的时候，通过生成对应操作的脚本代码，进行编辑操作。

调用示例

{
  "file_id": "doc_1234567890",
  "js_script": "
      // 获取当前活动的工作表
      const sheet = SpreadsheetApp.getActiveSheet();
      // 设置 A1 单元格的背景颜色为红色
      const range1 = sheet.getRange("A1");
      range1.setBackground("#ff0000");
      // 设置 A1:B2 范围的所有单元格为黄色背景
      const range2 = sheet.getRange("A1:B2");
      range2.setBackground("#ffff00");
  ",
  "sheet_id": "BB08J2",
}

参数说明

• file_id (string 必填)：在线文档 ID
• sheet_id (string 非必填)：表格工作表 ID，如果获取不到，默认为 BB08J2
• js_script (string 必填)：JavaScript 脚本内容，如上例所示，通过 js-script-rule.md 生成对应脚本