Sort
... 2026-2-4 大约 4 分钟
# Sort
在 Smartsheet 的某个表格中对记录进行排序的参数：
| 参数名 | 类型 | 描述 |
|---|---|---|
| fieldTitle | string | 需要排序的字段标题 |
| desc | bool | 是否进行降序排序，默认值为 false |
# CommonRecords
在 Smartsheet 的某个表格中添加记录响应、更新记录请求和更新记录响应的通用参数：
| 参数名 | 类型 | 描述 |
|---|---|---|
| recordID | string | 记录 ID |
| values | JSON Object | 记录的具体内容，key 为 fieldTitle，value 详见(Value) |
# Records
Smartsheet 的某个表格中记录相关的参数：
| 参数名 | 类型 | 描述 |
|---|---|---|
| recordID | string | 记录 ID |
| createTime | string | 记录的创建时间 |
| updateTime | string | 记录的更新时间 |
| values | JSON Object | 记录的具体内容，key 为 fieldTitle，value 详见(Value) |
# Value
各种类型的字段对应的单元格的参数类型：
| 类型 | 描述 |
|---|---|
| JSON Array(Textvalue) | 当字段为 文本 类型时，添加或更新记录所需参数的类型 |
| number(整数或浮点数) | 当字段为 数字 类型时，添加或更新记录所需参数的类型 |
| bool | 当字段为 复选框 类型时，添加或更新记录所需参数的类型 |
| string(值内容为以毫秒为单位的 unix 时间戳) | 当字段为 日期 类型时，查询、添加或更新记录 响应参数 的类型 |
| JSON Array(ImageValue) | 当字段为 图片 类型时，添加或更新记录所需参数的类型 |
| JSON Array(UrlValue) | 当字段为 超链接 类型时，添加或更新记录所需参数的类型 |
| JSON Array(OptionValue) | 当字段为 多选 类型时，添加或更新记录所需参数的类型 |
| number(整数或浮点数) | 当字段为 进度 类型时，添加或更新记录所需参数的类型 |
| string | 当字段为 电话 类型时，添加或更新记录所需参数的类型 |
| string | 当字段为 邮箱 类型时，添加或更新记录所需参数的类型 |
| JSON Array(OptionValue) | 当字段为 单选 类型时，添加或更新记录所需参数的类型 |
| JSON (AutoNumberValue) | 当字段为 自动编号 类型时，添加或更新记录所需参数的类型 |
| double | 当字段为 货币 类型时，添加或更新记录所需参数的类型 |
| JSON Array(AttachmentsValue) | 当字段为 文件 类型时，添加或更新记录所需参数的类型 |
| JSON Array(UserCValue) | 当字段为 人员 类型时，添加或更新记录所需参数的类型 |
| array string | 当字段为 关联 类型时，添加或更新记录所需参数的类型 |
| double | 当字段为 百分数 类型时，添加或更新记录所需参数的类型 |
# TextValue
添加文本类型的记录需要的参数：
| 参数名 | 类型 | 描述 |
|---|---|---|
| type | string | 类型（填 text） |
| text | string | 要写入的内容 |
# UrlValue
添加超链接类型的记录需要的参数：
| 参数名 | 类型 | 描述 |
|---|---|---|
| type | string | 类型（填 url） |
| text | string | 要写入的内容 |
| link | string | 超链接 |
# ImageValue
查询 / 添加 / 更新图片类型的记录的响应参数：
| 参数名 | 类型 | 描述 |
|---|---|---|
| id | string | 图片 ID |
| title | string | 图片标题 |
| imageUrl | string | 图片临时链接，有效期为 24 小时 |
| imageID | string | 上传图片临时链接 |
# OptionValue
添加单选或多选类型的记录需要的参数：
| 参数名 | 类型 | 描述 |
|---|---|---|
| id | string | 选项 ID |
| text | string | 要填写的选项内容 |
| style | integer(Style) | 选项颜色 |
# AutoNumberValue
自动编号类型的记录需要的参数：
| 参数名 | 类型 | 描述 |
|---|---|---|
| seq | string | 序号 |
| text | string | 内容 |
# AttachmentsValue
附件类型的记录需要的参数：
| 参数名 | 类型 | 描述 |
|---|---|---|
| name | string | 文件名 |
| classify | string | 文件类型 |
| fileExt | string | 文件后缀 |
| size | int | 大小 |
| fileId | string | 上传附件临时链接 |
# UserCValue
人员类型的记录需要的参数：
| 参数名 | 类型 | 描述 |
|---|---|---|
| name | string | 用户名 |
| userId | string | 用户id |
# LocationValue
查询 / 添加 / 更新位置字段的参数：
| 参数名 | 类型 | 描述 |
|---|---|---|
| id | string | 位置 id |
| latitude | string | 纬度 |
| longitude | string | 经度 |
| sourceType | enum | 枚举值 1 为腾讯地图 |
| title | string | 地图标题 |