添加记录
注意!!!
不能通过添加记录接口给文件、创建时间、最后编辑时间、创建人和最后编辑人五种类型的字段添加记录。该指令旨在通过智能表格API添加记录
参数配置
指令输入
常规
智能表格access_token:通过指令【建立智能表格连接】获取
智能表格ID(docid):字符串;文档ID
智能表格子表ID(sheet_id):字符串;子表ID
key类型:下拉框;元格的key类型,默认用标题(CELL_VALUE_KEY_TYPE_FIELD_TITLE), 字段 ID (CELL_VALUE_KEY_TYPE_FIELD_ID)
记录列表:任意值列表类型, 每个记录是一个字典,包含字段类型和对应的值

指令输出
响应内容:字典;返回响应内容
基础概念
关于字段节点结构详情请看 添加记录
文本类型:str, {"文本": "内容"}
数字类型:float, {"数字": 123.0}
复选框类型:bool, {"复选框": True}
日期时间类型:str,格式为 YYYY-MM-DD HH:mm:ss,{"日期": "2025-10-01 12:00:00"}
图片上传:str,上传图片地址,{"图片":r"D:\001.png"}
成员类型:str,上传成员id,{"成员":"xxxxx"}
超链接类型:str,{"超链接":"www.baidu.com"}
电话或邮件类型:str,{"电话": "1231231231123", "邮箱":"xxxxxxx"}
单选或多选类型:str or list,当为字符串类型时是单选,为列表时是多选,当选项不存在时自动创建选项,{"单选": "3","多选": ["2", "3"]}
地理位置类型:dict,来源为腾讯地图。目前只支持腾讯地图来源,{"地理位置":{"id": "10905255156366826898", "latitude": "30.291331", "longitude": "120.212998", "title": "杭州东站"}}
文件类型:
| 参数名 | 类型 | 描述 |
|---|---|---|
| name | string | 文件名 |
| size | int32 | 文件大小 |
| file_ext | string | 文件扩展名。文件夹为空,文件为对应文件拓展名,收集表为FORM,文档为DOC,表格为SHEET,幻灯片为SLIDE,思维导图为MIND,流程图为FLOWCHART,智能表为SMARTSHEET |
| file_id | string | 文件ID |
| file_url | string | 文件url ,如果是微盘文档则通过获取分享链接获得,如果是文档,则为文档url |
| file_type | string | 文件类型。文件夹为Folder,微盘文件为Wedrive,收集表为30,文档为50,表格是51,幻灯片为52,思维导图为54,流程图为55,智能表为70 |
| doc_type | string | 文件类型,用于区分文件夹和文件 |
{
"文件": [
{
"file_id": "s.ww8156d878fdf6f8d3.766540748uYa_f.766546853oWXD",
"name": "测试表格23.txt",
"size": 11131,
"file_type": "70",
"file_ext": "txt",
"doc_type": 2,
"file_url": "https://work.weixin.qq.com/wework_admin/frame#/wedrive/file/s.ww8156d878fdf6f8d3.766540748uYa_f.766546853oWXD"
}
]
}

可以在腾讯地图中获取(腾讯地图)
记录列表例子
CELL_VALUE_KEY_TYPE_FIELD_TITLE
{
"名称1": "张三1",
"数字字段": 1213,
"图片": r"D:\00.jpg",
"日期时间": "2025-10-01 12:50:00",
"单选": "3",
"多选": ["2", "3"],
"成员": "lifei",
"邮箱": "123456789@qq.com",
"电话": "12345678901",
"复选框": true,
"链接": "https://www.example.com",
"地理位置": {"id": "10905255156366826898", "latitude": "30.291331", "longitude": "120.212998", "title": "北京东站", "source_type": 1}
}
CELL_VALUE_KEY_TYPE_FIELD_ID(对应的FIELD_ID,通过指令【查询字段】获取)
{
"fHTCT7": "王五",
"fJAwwb": r"D:\00.jpg",
"fDsDxa": 1213,
"f2KZNy": "2025-10-01 12:50:00",
"fFILd7": "3",
"fa1IAw": ["2", "3"],
"fxH3Sn": "lifei",
"fVRYTj": "123456789@qq.com",
"faugh2": "12345678901",
"fMcwvd": true,
"f8deke": "https://www.example.com",
"fUrCOH": {"id": "10905255156366826898", "latitude": "30.291331", "longitude": "120.212998", "title": "北京东站", "source_type": 1}
}