数据校验概述
数据校验用于限制电子表格单元格中的数据类型或用户输入单元格的值。目前,电子表格支持下拉列表相关接口,用于验证数据。
下拉列表
下拉列表是验证数据有效性的一种方式。通过设置下拉列表,用户可以限制单元格中输入的内容必须为指定的值,从而保证数据的准确性和规范性。
另外,下拉列表也可用于信息整理、打标分类的场景。用户通过设置下拉列表中的颜色属性,使下拉列表中的选项更具区分度;还可设置下拉列表中选项的单选或多选属性,适应多样场景。
如下图,"性别"和"能力属性"列设置了下拉列表,限制用户可输入的内容必须为选项的值,且设置了下拉列表的颜色和单选多选属性。

方法列表
以下为下拉列表的方法列表。其中,“商店”代表应用商店应用;“自建”代表企业自建应用,了解更多应用相关信息,参考应用类型简介。了解调用服务端 API 的流程,参考流程概述。
| 方法 (API) | 权限要求(满足任一) | 访问凭证 | 商店 | 自建 |
|---|---|---|---|---|
``POST [设置下拉列表](https://open.larkoffice.com/document/ukTMukTMukTM/uATMzUjLwEzM14CMxMTN/datavalidation/set-dropdown) /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/dataValidation | drive:drive 查看、评论、编辑和管理云空间中所有文件 sheets:spreadsheet 查看、评论、编辑和管理电子表格 | tenant_access_token user_access_token | ✓ | ✓ |
``PUT [更新下拉列表设置](https://open.larkoffice.com/document/ukTMukTMukTM/uATMzUjLwEzM14CMxMTN/datavalidation/update-datavalidation) /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/dataValidation/:sheetId/:dataValidationId | drive:drive 查看、评论、编辑和管理云空间中所有文件 sheets:spreadsheet 查看、评论、编辑和管理电子表格 | tenant_access_token user_access_token | ✓ | ✓ |
``GET [查询下拉列表设置](https://open.larkoffice.com/document/ukTMukTMukTM/uATMzUjLwEzM14CMxMTN/datavalidation/query-datavalidation) /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/dataValidation | drive:drive 查看、评论、编辑和管理云空间中所有文件 sheets:spreadsheet 查看、评论、编辑和管理电子表格 | tenant_access_token user_access_token | ✓ | ✓ |
``DELETE [删除下拉列表设置](https://open.larkoffice.com/document/ukTMukTMukTM/uATMzUjLwEzM14CMxMTN/datavalidation/delete-datavalidation) /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/dataValidation | drive:drive 查看、评论、编辑和管理云空间中所有文件 sheets:spreadsheet 查看、评论、编辑和管理电子表格 | tenant_access_token user_access_token | ✓ | ✓ |
