更新记录
... 2026-2-4 大约 1 分钟
# 更新记录
# 接口说明
本接口用于更新 Smartsheet 中的某个子表里的一行或多行记录。
注意
不能通过更新记录接口给创建时间、最后编辑时间、创建人和最后编辑人四种类型的字段更新记录。
# 请求格式
| 描述 | 定义 |
|---|---|
| Path | /openapi/smartsheet/v2/files/{fileID}/sheets/{sheetID}/records |
| Method | POST |
| Content-Type | application/json |
| Accept | application/json |
# 请求头部
详见Headers。
# 请求参数
# 查询参数
无
# 请求体
| 参数名 | 类型 | 必选 | 描述 |
|---|---|---|---|
| updateRecords | JSON Object(UpdateRecordsRequest) | 是 | 更新记录请求 |
# 响应参数
# 请求体
| 参数名 | 类型 | 描述 |
|---|---|---|
| ret | integer | 业务返回码 |
| msg | string | 业务返回码描述 |
| data.updateRecords | JSON Object(UpdateRecordsResponse) | 更新记录响应 |
# 请求包体
POST /openapi/smartsheet/v2/files/DAAAAAAAAAAAA/sheets/at5j8y/records HTTP/1.1
Access-Token: ACCESS_TOKEN
Client-Id: CLIENT_ID
Content-Type: application/json
Content-Length: 1
{'updateRecords': {'records': [{'recordID': 'rMW8vK', 'values': {'文本': [{'type': 'text', 'text': '笔记'}]}}]}}
1
2
3
4
5
6
7
2
3
4
5
6
7
1
2
3
4
5
6
7
2
3
4
5
6
7
# 示例
curl --location --request POST 'https://{domain}/openapi/smartsheet/v2/files/DAAAAAAAAAAAA/sheets/at5j8y/records' \
--header 'Access-Token: ACCESS_TOKEN' \
--header 'Client-Id: CLIENT_ID' \
--header 'Content-Type: application/json' \
--data-raw '{
"updateRecords": {
"records": [{
"recordID": "rMW8vK",
"values": {
"文本": [
{
"type": "text",
"text": "笔记"
}
]
}
}]
}
}'
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19