表格接口参数说明
概述
参数详解
📍 range 参数 - 指定操作范围
{工作表名称}!{单元格范围}基本格式说明
| 组成部分 | 说明 | 示例 |
|---|---|---|
| 工作表名称 | 要操作的工作表名称 | 工作表1 |
! | 分隔符（必需） | - |
| 单元格范围 | 具体的单元格位置 | A1 或 A1:C10 |
单元格范围格式
单个单元格：A1, B5, Z100
范围选择：A1:C10, B2:F8工作表名称特殊字符处理
! （感叹号）: （冒号）' （单引号）完整示例
📊 resource 参数 - 表格数据内容
values 字段数据结构
数据类型说明
| 数据类型 | 表示方法 | 示例 |
|---|---|---|
| 文本 | 字符串 | "hello", "产品名称" |
| 数字 | 数值 | 123, 3.14, -50 |
| 空单元格 | 空字符串 | "" |
| 日期 | OADate 数值 | 44769 (表示 2022/7/27) |
实际应用示例
{
"resource": {
"values": [[1, "苹果", "水果"]]
}
}| A | B | C |
|---|---|---|
| 1 | 苹果 | 水果 |
{
"resource": {
"values": [
[1, "苹果", "水果"],
[2, "胡萝卜", "蔬菜"],
[3, "", "空白分类"]
]
}
}| A | B | C |
|---|---|---|
| 1 | 苹果 | 水果 |
| 2 | 胡萝卜 | 蔬菜 |
| 3 | (空) | 空白分类 |
{
"resource": {
"values": [
["产品", "", "价格"],
["", "苹果", 5.5],
["编号", "001", ""]
]
}
}📅 日期处理 - OADate 转换
2022/7/27 在接口中返回为 44769快速转换工具
完整转换函数（生产环境推荐）
常见问题与解决方案
❓ 常见错误
1.
2.
3.
💡 最佳实践
1.
2.
3.
4.
参数组合示例
完整的请求参数示例
修改于 2026-06-22 02:43:30