更新视图

... 2026-2-4 大约 1 分钟

# 更新视图

# 接口说明

本接口用于在 Smartsheet 中的某个子表里更新一个新视图。

# 请求格式

描述 定义
Path /openapi/smartsheet/v2/files/{fileID}/sheets/{sheetID}/views
Method PATCH
Content-Type application/json
Accept application/json

# 请求头部

详见Headers

# 请求参数

# 路径参数

参数名 类型 必选 描述
fileID string 文档唯一标识,详见fileID
sheetID string Smartsheet 子表 ID,详见子表 ID

# 查询参数

# 请求体

参数名 类型 必选 描述
updateView JSON Object(UpdateViewRequest) 添加视图请求

# 响应参数

# 请求体

参数名 类型 描述
updateView JSON Object(UpdateViewResponse) 添加视图响应

# 请求包体

curl --location --request PATCH 'https://{{domain}}/openapi/smartsheet/v2/files/DZVNFcEZBem1UcHhWQVNFZkdY/sheets/ss_8einmn/views' \
--header 'Access-Token: Access-Token' \
--header 'Client-Id: Client-Id' \
--header 'Content-Type: application/json' \
--data '{
    "updateView": {
        "viewId": "vMzzjG",
        "viewTitle": "智能表1测试2",
        "property": {
            "autoSort": true,
            "sortSpec": {},
            "filterSpec": {},
            "groupSpec": {},
            "isFieldStatEnabled": false,
            "fieldVisibility": {
                "f77jBW": true,
                "f8fFi6": true,
                "f9QDqq": true,
                "feZdAa": true,
                "fk1Xtt": false,
                "frrJnq": false,
                "fwjOxM": false,
                "fx5KTe": false
            },
            "frozenFieldCount": 1
        }
    }
}'
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

# 响应示例

{
    "updateView": {
        "view": {
            "viewID": "vMzzjG",
            "viewTitle": "智能表1测试2",
            "viewType": "VIEW_TYPE_GRID",
            "property": {
                "autoSort": true,
                "sortSpec": {},
                "filterSpec": {},
                "groupSpec": {},
                "isFieldStatEnabled": false,
                "fieldVisibility": {
                    "f77jBW": true,
                    "f8fFi6": true,
                    "f9QDqq": true,
                    "feZdAa": true,
                    "fk1Xtt": false,
                    "frrJnq": false,
                    "fwjOxM": false,
                    "fx5KTe": false
                },
                "frozenFieldCount": 1
            }
        }
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
上次编辑于: 2026年2月4日 15:01
贡献者: daleshen