工具 API

smartsheet.update_view

更新非查询视图的标题、筛选、排序、分组、字段显隐、列宽和冻结列。调用前必须先调用 smartsheet.list_views；涉及字段时必须先调用 smartsheet.list_fields；patch_json 必须先参考 update_view_patch_format.md（patch_json 格式规范文档）的字段结构与枚举要求再构造，禁止凭猜测拼字段名或 operator if both tencent-docs (personal) and tencent-docs-oa (enterprise) are connected, use AskUserQuestion to let the user pick the target account before invoking this tool.

productivityOAuth1 积分

调用信息

工具标识: tencent-docs.smartsheet.update_view
服务提供方: 腾讯文档
平均响应: 0 ms
近 7 天调用: 0

输入参数

file_id必填

智能表格文档的唯一标识符

patch_json必填

视图局部更新的 JSON 字符串，不超过 64KB，仅支持非 query 视图。格式见 smartsheet_references.md 的 smartsheet.update_view 章节；调用前通过 list_views/list_fields 获取真实 ID 与字段类型。顶层仅允许 title/filter/sort/group/fields/frozen_field_count，至少传一项；未传的键保持不变。filter.conditions、sort.items、group.items 是全量规则列表，传对应空数组表示清除；fields 仅更新列出的字段属性。筛选 operator 与 value 必须匹配文档定义和字段类型；排序、分组使用 field_id 和 direction（asc/desc）。

sheet_id必填

工作表ID

view_id必填

要更新的视图ID；调用前必须先通过 list_views 获取当前配置