更新下拉列表设置

PUT

/open-apis/sheets/v2/spreadsheets/{spreadsheetToken}/dataValidation/{sheetId}/{dataValidationId}

该接口根据 spreadsheetToken 、sheetId、dataValidationId 更新下拉列表的属性。

错误码

具体可参考：服务端错误码说明

请求示例

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://open.feishu.cn/open-apis/sheets/v2/spreadsheets//dataValidation//' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "dataValidationType":"list",
    "dataValidation":{
        "conditionValues":["1", "2", "4","2"],
        "options":{
            "multipleValues":false,
            "highlightValidData":true,
            "colors":["#1FB6C1", "#1006C2", "#FB16C3","#FFB6C1"]
        }
    }
}'

响应示例

{
    "code": 0,
    "data": {
        "dataValidation": {
            "conditionValues": [
                "1",
                "2",
                "4"
            ],
            "dataValidationId": 2,
            "dataValidationType": "list",
            "options": {
                "colorValueMap": {
                    "1": "#1FB6C1",
                    "2": "#1006C2",
                    "4": "#FB16C3"
                },
                "highlightValidData": true,
                "multipleValues": false
            }
        },
        "sheetId": "yuNGtr",
        "spreadsheetToken": "shtbckBcolBlRfkcMVZbolMdADe"
    },
    "msg": "Success"
}

请求参数

Path 参数

spreadsheetToken

string

必需

spreadsheet 的 token，获取方式见在线表格开发指南

sheetId

string

必需

子sheet唯一识别参数

dataValidationId

string

必需

sheet中下拉列表的唯一标示id

Header 参数

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

Content-Type

string

必需

固定值："application/json; charset=utf-8"

默认值:

application/json; charset=utf-8

Body 参数application/json

dataValidationType

string

必需

下拉列表填"list"

dataValidation

object

下拉列表规则属性

必需

conditionValues

array[string]

必需

下拉列表选项值, 需为字符串,不能包含","，选项值最长100字符,选项个数最多500个

options

object

可选属性

必需

示例

返回响应

🟢200成功

application/json

Body

code

integer

状态码，0代表成功

必需

data

object

必需

dataValidation

object

必需

sheetId

string

必需

工作表 sheet 的 id

spreadsheetToken

string

必需

spreadsheet的token

msg

string

状态信息

必需

修改于 2023-01-18 06:32:54

删除下拉列表设置

查询下拉列表设置

更新下拉列表设置

错误码#

请求参数

返回响应

错误码