更新筛选视图

PATCH

/sheets/v3/spreadsheets/{spreadsheet_token}/sheets/{sheet_id}/filter_views/{filter_view_id}

更新筛选视图的名字或者筛选范围。名字长度不超过100，不能重复即子表内唯一；筛选范围不超过子表的最大范围。
筛选范围的设置参考：筛选视图的筛选条件指南

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

Body 参数application/json

示例

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request PATCH '/sheets/v3/spreadsheets/shtcnmBA*****yGehy8/sheets/0b**12/filter_views/pH9hbVcCXA' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "filter_view_name": "筛选视图 1",
    "range": "0b**12!C1:H14"
}'

响应示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "filter_view": {
            "filter_view_id": "pH9hbVcCXA",
            "filter_view_name": "筛选视图 1",
            "range": "0b**12!C1:H14"
        }
    }
}

修改于 2025-10-21 06:20:48

获取筛选条件

获取筛选视图