51 lines
1.4 KiB
Markdown
51 lines
1.4 KiB
Markdown
|
# Sheet 表格操作参考文档
|
|||
|
|
|
|||
|
|
本文件包含腾讯文档 MCP 中 Sheet（在线表格）相关工具的完整 API 说明、详细调用示例、参数说明和返回值说明。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 通用说明
|
|||
|
|
|
|||
|
|
### Sheet 工具概述
|
|||
|
|
|
|||
|
|
Sheet 工具专门用于操作腾讯文档中的在线表格（Excel格式），提供表格信息的查询、范围数据的获取以及批量更新等功能。
|
|||
|
|
|
|||
|
|
### 响应结构
|
|||
|
|
|
|||
|
|
所有 API 返回都包含：
|
|||
|
|
- `error`: 错误信息（成功时为空）
|
|||
|
|
- `trace_id`: 调用链追踪 ID
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 工具调用示例
|
|||
|
|
|
|||
|
|
## OperationSheet
|
|||
|
|
|
|||
|
|
### 功能说明
|
|||
|
|
进行表格编辑操作的时候，通过生成对应操作的脚本代码，进行编辑操作。
|
|||
|
|
|
|||
|
|
#### 调用示例
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"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 生成对应脚本
|