# 电子表格概述 本文档介绍飞书开放平台电子表格能力相关的基本概念、使用限制、接入流程、方法列表等。 ## 接入流程 接入电子表格 OpenAPI 的流程如下图所示。了解更多，参考[云文档-概述](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/docs-overview) 的 **接入流程** 一节。 ![image.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/910476e4674986957601e29f93ba9538_MV0JVXjLH8.png?height=546&lazyload=true&maxWidth=750&width=6382) ## 鉴权说明 使用 `tenant_access_token` 访问、操作电子表格资源之前，请确保应用已有电子表格的阅读、编辑、管理等文档权限，否则接口将返回 HTTP 403 或 400 状态码。了解更多，参考[开通文档、电子表格等云文档资源权限](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-add-permissions-to-app#223459af)。 ## 基础概念 电子表格 OpenAPI 中，基础概念为表格（spreadsheet）、工作表（sheet）和范围（range）。 ### 表格 表格是承载数据的容器，提供数据处理、展示、分析的功能。一个表格包含一个或多个工作表。 每个表格都有一个 `spreadsheetToken` 作为唯一标识。你可通过以下任一方式获取表格的 `spreadsheetToken`： - 电子表格的 URL：https://sample.feishu.cn/sheets/==Iow7sNNEphp3WbtnbCscPqabcef== - 通过调用[获取文件夹中的文件清单](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/list) 获取。当响应体中的 type 为 sheet 时，对应的 token 即为电子表格的 spreadsheetTokenwarning 对于知识库中的电子表格，你需调用[获取知识空间节点信息](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space/get_node)接口来获取电子表格的 `obj_token`。此时，该 `obj_token` 也是该表格的 `spreadsheetToken`。 ### 工作表 工作表（sheet）是表格中的单独页面。每个工作表都有自己的行和列，形成一个网格，用于组织和存储数据。 每一个工作表都有唯一的 `sheetId` 作为标识。你可通过以下任一方式获取工作表的 `sheetId`： - 表格的 URL：https://sample.feishu.cn/sheets/Iow7sNNEphp3WbtnbCscPqabcef?sheet===giDk9k== - 通过调用[获取工作表](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet/query)获取 ### 范围 在工作表中进行读取数据、写入数据、筛选数据等各类操作时，你需要通过 范围 `range` 参数指定操作数据的范围。`range` 参数的格式为 `!<开始位置>:<结束位置>`。其中： - `sheetId` 为工作表的唯一标识，通过[获取工作表](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet/query) 获取。 - `<开始位置>:<结束位置>` 为工作表中单元格的范围，使用数字表示行索引，字母表示列索引。如 `A2:B2` 表示该工作表第 2 行的 A 列到 B 列。 `range` 参数共有 4 种写法，分别为： range 写法 | 示例 | 描述 | 图示 ---|---|---|--- <sheetId>!<开始单元格>:<结束单元格> | 0bdf12!A1:B5 | ID 为 <0bdf12> 的工作表中，从 A1 到 B5 的区域。 | ![image.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/76498891d78bff326b0bcffe43427fa9_fUFkCG77Vw.png?height=484&lazyload=true&maxWidth=222&width=722) <sheetId>!<开始列>:<结束列> | 0bdf12!A:B | ID 为 <0bdf12> 的工作表中，从 A 列到 B 列的区域。 | ![image.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/c6a46f088f63e2f4c81dc6bc41811b2c_ZkQTxGQ1m5.png?height=596&lazyload=true&maxWidth=222&width=534) <sheetId>!<开始单元格>:<结束列> | 0bdf12!A2:B | ID 为 <0bdf12> 的工作表中，从 A2 所在行到结束行的行范围、A 列到 B 列的列范围圈定的区域。 | ![image.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/f727b1806cd1a5cbe6ceb74ecb6c2ed5_pyYMAKxMfB.png?height=564&lazyload=true&maxWidth=222&width=537) <sheetId> | ID 为 <sheetId> 的工作表的所有区域。 | 0bdf12 | / ## 使用限制 电子表格整体有如下限制： - 单个电子表格中工作表的数量不可超过 300 个 - 单个工作表中列的数量不可超过 13,000 列（包含空列） - 单个工作表中单元格的数量不可超过 5,000,000 个（包含空单元格） - 单个单元格不超过 50,000 字符，由于服务端会增加控制字符，因此推荐每个单元格不超过 40,000 字符。 - 单篇文档中电子表格的数量不可超过 1,500 个 电子表格相关接口有如下频率限制。你也可以在每个接口请求的基本信息中找到接口频率限制信息。 | 接口 | 限流值 | | ------------------ | ---------------------------------------------- | | [创建表格](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet/create) |单租户单应用20次/分钟 | | [修改电子表格属性](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet/patch)| 单租户单应用20次/分钟 | | [获取电子表格信息](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet/get) | 单租户单应用100次/分钟 | | [操作工作表](https://open.feishu.cn/document/ukTMukTMukTM/uYTMzUjL2EzM14iNxMTN) | 单租户单应用100次/秒 | | [更新工作表属性](https://open.feishu.cn/document/ukTMukTMukTM/ugjMzUjL4IzM14COyMTN) | 单租户单应用100次/秒；单个文档只能串行调用 | | [移动行列](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet/move_dimension) | 单租户单应用100次/分钟 | | [插入数据](https://open.feishu.cn/document/ukTMukTMukTM/uIjMzUjLyIzM14iMyMTN) | 单租户单应用100次/秒；单个文档只能串行调用 | | [追加数据](https://open.feishu.cn/document/ukTMukTMukTM/uMjMzUjLzIzM14yMyMTN) | 单租户单应用100次/秒；单个文档只能串行调用 | | [插入行列](https://open.feishu.cn/document/ukTMukTMukTM/uQjMzUjL0IzM14CNyMTN) | 单租户单应用100次/秒；单个文档只能串行调用 | | [增加行列](https://open.feishu.cn/document/ukTMukTMukTM/uUjMzUjL1IzM14SNyMTN) | 单租户单应用100次/秒；单个文档只能串行调用 | | [更新行列](https://open.feishu.cn/document/ukTMukTMukTM/uYjMzUjL2IzM14iNyMTN) | 单租户单应用100次/秒；单个文档只能串行调用 | | [删除行列](https://open.feishu.cn/document/ukTMukTMukTM/ucjMzUjL3IzM14yNyMTN) | 单租户单应用100次/秒；单个文档只能串行调用 | | [读取单个范围](https://open.feishu.cn/document/ukTMukTMukTM/ugTMzUjL4EzM14COxMTN) | 单租户单应用100次/秒 | | [读取多个范围](https://open.feishu.cn/document/ukTMukTMukTM/ukTMzUjL5EzM14SOxMTN) | 单租户单应用100次/秒 | | [向单个范围写入数据](https://open.feishu.cn/document/ukTMukTMukTM/uAjMzUjLwIzM14CMyMTN)| 单租户单应用100次/秒；单个文档只能串行调用 | | [向多个范围写入数据](https://open.feishu.cn/document/ukTMukTMukTM/uEjMzUjLxIzM14SMyMTN)| 单租户单应用100次/秒；单个文档只能串行调用 | | [设置单元格样式](https://open.feishu.cn/document/ukTMukTMukTM/ukjMzUjL5IzM14SOyMTN) | 单租户单应用100次/秒；单个文档只能串行调用 | | [批量设置单元格样式](https://open.feishu.cn/document/ukTMukTMukTM/uAzMzUjLwMzM14CMzMTN)| 单租户单应用100次/秒；单个文档只能串行调用 | | [合并单元格](https://open.feishu.cn/document/ukTMukTMukTM/ukDNzUjL5QzM14SO0MTN) | 单租户单应用100次/秒；单个文档只能串行调用 | | [拆分单元格](https://open.feishu.cn/document/ukTMukTMukTM/uATNzUjLwUzM14CM1MTN) | 单租户单应用100次/秒；单个文档只能串行调用 | | [写入图片](https://open.feishu.cn/document/ukTMukTMukTM/uUDNxYjL1QTM24SN0EjN) | 单租户单应用100次/秒；单个文档只能串行调用 | | [查找单元格](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet/find) | 单租户单应用100次/分钟 | | [替换单元格](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet/replace) | 单租户单应用20次/分钟 | | [创建条件格式](https://open.feishu.cn/document/ukTMukTMukTM/uATMzUjLwEzM14CMxMTN/conditionformat/condition-format-set) | 单租户单应用100次/秒；单个文档只能串行调用 | | [获取条件格式](https://open.feishu.cn/document/ukTMukTMukTM/uATMzUjLwEzM14CMxMTN/conditionformat/condition-format-get) | 单租户单应用100次/秒；单个文档只能串行调用 | | [更新条件格式](https://open.feishu.cn/document/ukTMukTMukTM/uATMzUjLwEzM14CMxMTN/conditionformat/condition-format-update) | 单租户单应用100次/秒；单个文档只能串行调用 | | [删除条件格式](https://open.feishu.cn/document/ukTMukTMukTM/uATMzUjLwEzM14CMxMTN/conditionformat/condition-format-delete) | 单租户单应用100次/秒；单个文档只能串行调用 | | [增加保护范围](https://open.feishu.cn/document/ukTMukTMukTM/ugDNzUjL4QzM14CO0MTN) | 单租户单应用100次/秒；单个文档只能串行调用 | | [获取保护范围](https://open.feishu.cn/document/ukTMukTMukTM/uQTM5YjL0ETO24CNxkjN) | 单租户单应用100次/秒；单个文档只能串行调用 | | [修改保护范围](https://open.feishu.cn/document/ukTMukTMukTM/uUTM5YjL1ETO24SNxkjN) | 单租户单应用100次/秒；单个文档只能串行调用 | | [删除保护范围](https://open.feishu.cn/document/ukTMukTMukTM/uYTM5YjL2ETO24iNxkjN) | 单租户单应用100次/秒；单个文档只能串行调用 | | [设置下拉列表](https://open.feishu.cn/document/ukTMukTMukTM/uATMzUjLwEzM14CMxMTN/datavalidation/set-dropdown) | 单租户单应用100次/秒；单个文档只能串行调用 | | [删除下拉列表设置](https://open.feishu.cn/document/ukTMukTMukTM/uATMzUjLwEzM14CMxMTN/datavalidation/delete-datavalidation)| 单租户单应用100次/秒；单个文档只能串行调用 | | [更新下拉列表设置](https://open.feishu.cn/document/ukTMukTMukTM/uATMzUjLwEzM14CMxMTN/datavalidation/update-datavalidation)| 单租户单应用100次/秒；单个文档只能串行调用 | | [查询下拉列表设置](https://open.feishu.cn/document/ukTMukTMukTM/uATMzUjLwEzM14CMxMTN/datavalidation/query-datavalidation)| 单租户单应用100次/秒；单个文档只能串行调用 | | [获取筛选](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter/get) | 单租户单应用100次/分钟 | | [创建筛选](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter/create) | 单租户单应用20次/分钟 | | [更新筛选](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter/update) | 单租户单应用20次/分钟 | | [删除筛选](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter/delete) | 单租户单应用100次/分钟 | | [创建筛选视图](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view/create) | 单租户单应用100次/分钟 | | [获取筛选视图](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view/get) | 单租户单应用100次/分钟 | | [查询筛选视图](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view/query) | 单租户单应用100次/分钟 | | [更新筛选视图](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view/patch) | 单租户单应用100次/分钟 | | [删除筛选视图](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view/delete) | 单租户单应用100次/分钟 | | [创建筛选条件](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view-condition/create) | 单租户单应用100次/分钟 | | [获取筛选条件](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view-condition/get) | 单租户单应用100次/分钟 | | [查询筛选条件](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view-condition/query) | 单租户单应用100次/分钟 | | [更新筛选条件](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view-condition/update) | 单租户单应用100次/分钟 | | [删除筛选条件](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view-condition/delete) | 单租户单应用100次/分钟 | | [创建浮动图片](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-float_image/create) | 单租户单应用100次/分钟 | | [获取浮动图片](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-float_image/get) | 单租户单应用100次/分钟 | | [查询浮动图片](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-float_image/query) | 单租户单应用100次/分钟 | | [更新浮动图片](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-float_image/patch) | 单租户单应用100次/分钟 | | [删除浮动图片](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-float_image/delete) | 单租户单应用100次/分钟 | ## 方法列表 以下为电子表格的方法列表。其中，“商店”代表应用商店应用；“自建”代表企业自建应用，了解更多应用相关信息，参考[应用类型简介](https://open.feishu.cn/document/home/app-types-introduction/overview)。了解调用服务端 API 的流程，参考[流程概述](https://open.feishu.cn/document/uMzNwEjLzcDMx4yM3ATM/ugzNwEjL4cDMx4CO3ATM)。 ### 表格 **[方法 (API)](https://open.feishu.cn/document/ukTMukTMukTM/uITNz4iM1MjLyUzM)** | 权限要求（满足任一） | **[访问凭证](https://open.feishu.cn/document/ukTMukTMukTM/uMTNz4yM1MjLzUzM)（选择其一）** | 商店 | 自建 ---|---|---|---|--- [创建电子表格](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet/create)
`POST` /open-apis/sheets/v3/spreadsheets | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [获取电子表格信息](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet/get)
`GET` /open-apis/sheets/v3/spreadsheets/:spreadsheet_token | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论和下载云空间中所有文件(drive:drive:readonly)
查看、评论、编辑和管理电子表格(sheets:spreadsheet)
查看、评论和导出电子表格(sheets:spreadsheet:readonly) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [修改电子表格属性](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet/patch)
`PUT` /open-apis/sheets/v3/spreadsheets/:spreadsheet_token | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** ### 工作表 **[方法 (API)](https://open.feishu.cn/document/ukTMukTMukTM/uITNz4iM1MjLyUzM)** | 权限要求（满足任一） | **[访问凭证](https://open.feishu.cn/document/ukTMukTMukTM/uMTNz4yM1MjLzUzM)（选择其一）** | 商店 | 自建 ---|---|---|---|--- [更新工作表属性](https://open.feishu.cn/document/ukTMukTMukTM/ugjMzUjL4IzM14COyMTN)
`POST` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/sheets_batch_update | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [操作工作表](https://open.feishu.cn/document/ukTMukTMukTM/uYTMzUjL2EzM14iNxMTN)
`POST` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/sheets_batch_update | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** ### 工作表 - 条件格式 **[方法 (API)](https://open.feishu.cn/document/ukTMukTMukTM/uITNz4iM1MjLyUzM)** | 权限要求（满足任一） | **[访问凭证](https://open.feishu.cn/document/ukTMukTMukTM/uMTNz4yM1MjLzUzM)（选择其一）** | 商店 | 自建 ---|---|---|---|--- [创建条件格式](https://open.feishu.cn/document/ukTMukTMukTM/uATMzUjLwEzM14CMxMTN/conditionformat/condition-format-set)
`POST` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/condition_formats/batch_create | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [获取条件格式](https://open.feishu.cn/document/ukTMukTMukTM/uATMzUjLwEzM14CMxMTN/conditionformat/condition-format-get)
`GET` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/condition_formats | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论和下载云空间中所有文件(drive:drive:readonly)
查看、评论、编辑和管理电子表格(sheets:spreadsheet)
查看、评论和导出电子表格(sheets:spreadsheet:readonly) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [更新条件格式](https://open.feishu.cn/document/ukTMukTMukTM/uATMzUjLwEzM14CMxMTN/conditionformat/condition-format-update)
`POST` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/condition_formats/batch_update | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [删除条件格式](https://open.feishu.cn/document/ukTMukTMukTM/uATMzUjLwEzM14CMxMTN/conditionformat/condition-format-delete)
`DELETE` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/condition_formats/batch_delete | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** ### 工作表 - 筛选 **[方法 (API)](https://open.feishu.cn/document/ukTMukTMukTM/uITNz4iM1MjLyUzM)** | 权限要求（满足任一） | **[访问凭证](https://open.feishu.cn/document/ukTMukTMukTM/uMTNz4yM1MjLzUzM)（选择其一）** | 商店 | 自建 ---|---|---|---|--- [获取筛选](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter/get)
`GET` /open-apis/sheets/v3/spreadsheets/:spreadsheet_token/sheets/:sheet_id/filter | $$$sheets.v3.scope.sheets.v3.scope.sheets:spreadsheet.desc.desc$$$(sheets:spreadsheet)
$$$sheets.v3.scope.sheets.v3.scope.sheets:spreadsheet:readonly.desc.desc$$$(sheets:spreadsheet:readonly)
$$$sheets.v3.scope.sheets.v3.scope.drive:drive.desc.desc$$$(drive:drive)
$$$sheets.v3.scope.sheets.v3.scope.drive:drive:readonly.desc.desc$$$(drive:drive:readonly) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [创建筛选](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter/create)
`POST` /open-apis/sheets/v3/spreadsheets/:spreadsheet_token/sheets/:sheet_id/filter | $$$sheets.v3.scope.sheets.v3.scope.sheets:spreadsheet.desc.desc$$$(sheets:spreadsheet)
$$$sheets.v3.scope.sheets.v3.scope.drive:drive.desc.desc$$$(drive:drive) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [更新筛选](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter/update)
`PUT` /open-apis/sheets/v3/spreadsheets/:spreadsheet_token/sheets/:sheet_id/filter | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [删除筛选](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter/delete)
`DELETE` /open-apis/sheets/v3/spreadsheets/:spreadsheet_token/sheets/:sheet_id/filter | $$$sheets.v3.scope.sheets.v3.scope.sheets:spreadsheet.desc.desc$$$(sheets:spreadsheet)
$$$sheets.v3.scope.sheets.v3.scope.drive:drive.desc.desc$$$(drive:drive) | `tenant_access_token`
`user_access_token` | **✓** | **✓** ### 工作表 - 筛选视图 **[方法 (API)](https://open.feishu.cn/document/ukTMukTMukTM/uITNz4iM1MjLyUzM)** | 权限要求（满足任一） | **[访问凭证](https://open.feishu.cn/document/ukTMukTMukTM/uMTNz4yM1MjLzUzM)（选择其一）** | 商店 | 自建 ---|---|---|---|--- [删除筛选视图](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view/delete)
`DELETE` /open-apis/sheets/v3/spreadsheets/:spreadsheet_token/sheets/:sheet_id/filter_views/:filter_view_id | $$$sheets.v3.scope.sheets.v3.scope.drive:drive.desc.desc$$$(drive:drive)
$$$sheets.v3.scope.sheets.v3.scope.sheets:spreadsheet.desc.desc$$$(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [更新筛选视图](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view/patch)
`PATCH` /open-apis/sheets/v3/spreadsheets/:spreadsheet_token/sheets/:sheet_id/filter_views/:filter_view_id | $$$sheets.v3.scope.sheets.v3.scope.sheets:spreadsheet.desc.desc$$$(sheets:spreadsheet)
$$$sheets.v3.scope.sheets.v3.scope.drive:drive.desc.desc$$$(drive:drive) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [查询筛选视图](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view/query)
`GET` /open-apis/sheets/v3/spreadsheets/:spreadsheet_token/sheets/:sheet_id/filter_views/query | $$$sheets.v3.scope.sheets.v3.scope.sheets:spreadsheet:readonly.desc.desc$$$(sheets:spreadsheet:readonly)
$$$sheets.v3.scope.sheets.v3.scope.drive:drive.desc.desc$$$(drive:drive)
$$$sheets.v3.scope.sheets.v3.scope.drive:drive:readonly.desc.desc$$$(drive:drive:readonly)
$$$sheets.v3.scope.sheets.v3.scope.sheets:spreadsheet.desc.desc$$$(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [获取筛选视图](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view/get)
`GET` /open-apis/sheets/v3/spreadsheets/:spreadsheet_token/sheets/:sheet_id/filter_views/:filter_view_id | $$$sheets.v3.scope.sheets.v3.scope.sheets:spreadsheet.desc.desc$$$(sheets:spreadsheet)
$$$sheets.v3.scope.sheets.v3.scope.sheets:spreadsheet:readonly.desc.desc$$$(sheets:spreadsheet:readonly)
$$$sheets.v3.scope.sheets.v3.scope.drive:drive.desc.desc$$$(drive:drive)
$$$sheets.v3.scope.sheets.v3.scope.drive:drive:readonly.desc.desc$$$(drive:drive:readonly) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [创建筛选视图](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view/create)
`POST` /open-apis/sheets/v3/spreadsheets/:spreadsheet_token/sheets/:sheet_id/filter_views | $$$sheets.v3.scope.sheets.v3.scope.sheets:spreadsheet.desc.desc$$$(sheets:spreadsheet)
$$$sheets.v3.scope.sheets.v3.scope.drive:drive.desc.desc$$$(drive:drive) | `tenant_access_token`
`user_access_token` | **✓** | **✓** ### 筛选视图 - 筛选条件 **[方法 (API)](https://open.feishu.cn/document/ukTMukTMukTM/uITNz4iM1MjLyUzM)** | 权限要求（满足任一） | **[访问凭证](https://open.feishu.cn/document/ukTMukTMukTM/uMTNz4yM1MjLzUzM)（选择其一）** | 商店 | 自建 ---|---|---|---|--- [删除筛选条件](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view-condition/delete)
`DELETE` /open-apis/sheets/v3/spreadsheets/:spreadsheet_token/sheets/:sheet_id/filter_views/:filter_view_id/conditions/:condition_id | $$$sheets.v3.scope.sheets.v3.scope.sheets:spreadsheet.desc.desc$$$(sheets:spreadsheet)
$$$sheets.v3.scope.sheets.v3.scope.drive:drive.desc.desc$$$(drive:drive) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [更新筛选条件](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view-condition/update)
`PUT` /open-apis/sheets/v3/spreadsheets/:spreadsheet_token/sheets/:sheet_id/filter_views/:filter_view_id/conditions/:condition_id | $$$sheets.v3.scope.sheets.v3.scope.sheets:spreadsheet.desc.desc$$$(sheets:spreadsheet)
$$$sheets.v3.scope.sheets.v3.scope.drive:drive.desc.desc$$$(drive:drive) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [查询筛选条件](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view-condition/query)
`GET` /open-apis/sheets/v3/spreadsheets/:spreadsheet_token/sheets/:sheet_id/filter_views/:filter_view_id/conditions/query | $$$sheets.v3.scope.sheets.v3.scope.sheets:spreadsheet.desc.desc$$$(sheets:spreadsheet)
$$$sheets.v3.scope.sheets.v3.scope.sheets:spreadsheet:readonly.desc.desc$$$(sheets:spreadsheet:readonly)
$$$sheets.v3.scope.sheets.v3.scope.drive:drive.desc.desc$$$(drive:drive)
$$$sheets.v3.scope.sheets.v3.scope.drive:drive:readonly.desc.desc$$$(drive:drive:readonly) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [获取筛选条件](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view-condition/get)
`GET` /open-apis/sheets/v3/spreadsheets/:spreadsheet_token/sheets/:sheet_id/filter_views/:filter_view_id/conditions/:condition_id | $$$sheets.v3.scope.sheets.v3.scope.drive:drive:readonly.desc.desc$$$(drive:drive:readonly)
$$$sheets.v3.scope.sheets.v3.scope.sheets:spreadsheet.desc.desc$$$(sheets:spreadsheet)
$$$sheets.v3.scope.sheets.v3.scope.sheets:spreadsheet:readonly.desc.desc$$$(sheets:spreadsheet:readonly)
$$$sheets.v3.scope.sheets.v3.scope.drive:drive.desc.desc$$$(drive:drive) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [创建筛选条件](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter_view-condition/create)
`POST` /open-apis/sheets/v3/spreadsheets/:spreadsheet_token/sheets/:sheet_id/filter_views/:filter_view_id/conditions | $$$sheets.v3.scope.sheets.v3.scope.sheets:spreadsheet.desc.desc$$$(sheets:spreadsheet)
$$$sheets.v3.scope.sheets.v3.scope.drive:drive.desc.desc$$$(drive:drive) | `tenant_access_token`
`user_access_token` | **✓** | **✓** ### 工作表 - 行列 **[方法 (API)](https://open.feishu.cn/document/ukTMukTMukTM/uITNz4iM1MjLyUzM)** | 权限要求（满足任一） | **[访问凭证](https://open.feishu.cn/document/ukTMukTMukTM/uMTNz4yM1MjLzUzM)（选择其一）** | 商店 | 自建 ---|---|---|---|--- [删除行列](https://open.feishu.cn/document/ukTMukTMukTM/ucjMzUjL3IzM14yNyMTN)
`DELETE` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/dimension_range | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [更新行列](https://open.feishu.cn/document/ukTMukTMukTM/uYjMzUjL2IzM14iNyMTN)
`PUT` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/dimension_range | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [增加行列](https://open.feishu.cn/document/ukTMukTMukTM/uUjMzUjL1IzM14SNyMTN)
`POST` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/dimension_range | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [插入行列](https://open.feishu.cn/document/ukTMukTMukTM/uQjMzUjL0IzM14CNyMTN)
`POST` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/insert_dimension_range | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [移动行列](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet/move_dimension)
`POST` /open-apis/sheets/v3/spreadsheets/:spreadsheet_token/sheets/:sheet_id/move_dimension | $$$sheets.v3.scope.sheets.v3.scope.drive:drive.desc.desc$$$(drive:drive)
$$$sheets.v3.scope.sheets.v3.scope.sheets:spreadsheet.desc.desc$$$(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** ### 行列 - 保护范围 **[方法 (API)](https://open.feishu.cn/document/ukTMukTMukTM/uITNz4iM1MjLyUzM)** | 权限要求（满足任一） | **[访问凭证](https://open.feishu.cn/document/ukTMukTMukTM/uMTNz4yM1MjLzUzM)（选择其一）** | 商店 | 自建 ---|---|---|---|--- [增加保护范围](https://open.feishu.cn/document/ukTMukTMukTM/ugDNzUjL4QzM14CO0MTN)
`POST` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/protected_dimension | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [获取保护范围](https://open.feishu.cn/document/ukTMukTMukTM/uQTM5YjL0ETO24CNxkjN)
`GET` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/protected_range_batch_get | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [修改保护范围](https://open.feishu.cn/document/ukTMukTMukTM/uUTM5YjL1ETO24SNxkjN)
`POST` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/protected_range_batch_update | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [删除保护范围](https://open.feishu.cn/document/ukTMukTMukTM/uYTM5YjL2ETO24iNxkjN)
`DELETE` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/protected_range_batch_del | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** ### 工作表 - 数据 **[方法 (API)](https://open.feishu.cn/document/ukTMukTMukTM/uITNz4iM1MjLyUzM)** | 权限要求（满足任一） | **[访问凭证](https://open.feishu.cn/document/ukTMukTMukTM/uMTNz4yM1MjLzUzM)（选择其一）** | 商店 | 自建 ---|---|---|---|--- [插入数据](https://open.feishu.cn/document/ukTMukTMukTM/uIjMzUjLyIzM14iMyMTN)
`POST` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/values_prepend | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [追加数据](https://open.feishu.cn/document/ukTMukTMukTM/uMjMzUjLzIzM14yMyMTN)
`POST` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/values_append | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [读取单个范围](https://open.feishu.cn/document/ukTMukTMukTM/ugTMzUjL4EzM14COxMTN)
`GET` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/values/:range | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论和下载云空间中所有文件(drive:drive:readonly)
查看、评论、编辑和管理电子表格(sheets:spreadsheet)
查看、评论和导出电子表格(sheets:spreadsheet:readonly) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [读取多个范围](https://open.feishu.cn/document/ukTMukTMukTM/ukTMzUjL5EzM14SOxMTN)
`GET` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/values_batch_get | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论和下载云空间中所有文件(drive:drive:readonly)
查看、评论、编辑和管理电子表格(sheets:spreadsheet)
查看、评论和导出电子表格(sheets:spreadsheet:readonly) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [向单个范围写入数据](https://open.feishu.cn/document/ukTMukTMukTM/uAjMzUjLwIzM14CMyMTN)
`PUT` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/values | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [向多个范围写入数据](https://open.feishu.cn/document/ukTMukTMukTM/uEjMzUjLxIzM14SMyMTN)
`POST` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/values_batch_update | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [设置单元格样式 ](https://open.feishu.cn/document/ukTMukTMukTM/ukjMzUjL5IzM14SOyMTN)
`PUT` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/style | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [批量设置单元格样式 ](https://open.feishu.cn/document/ukTMukTMukTM/uAzMzUjLwMzM14CMzMTN)
`PUT` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/styles_batch_update | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [合并单元格](https://open.feishu.cn/document/ukTMukTMukTM/ukDNzUjL5QzM14SO0MTN)
`POST` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/merge_cells | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [拆分单元格](https://open.feishu.cn/document/ukTMukTMukTM/uATNzUjLwUzM14CM1MTN)
`POST` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/unmerge_cells | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [写入图片](https://open.feishu.cn/document/ukTMukTMukTM/uUDNxYjL1QTM24SN0EjN)
`POST` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/values_image | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [查找单元格](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet/find)
`POST` /open-apis/sheets/v3/spreadsheets/:spreadsheet_token/sheets/:sheet_id/find | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet)
查看、评论和下载云空间中所有文件(drive:drive:readonly)
查看、评论和导出电子表格(sheets:spreadsheet:readonly) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [替换单元格](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet/replace)
`POST` /open-apis/sheets/v3/spreadsheets/:spreadsheet_token/sheets/:sheet_id/replace | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** ### 工作表 - 浮动图片 **[方法 (API)](https://open.feishu.cn/document/ukTMukTMukTM/uITNz4iM1MjLyUzM)** | 权限要求（满足任一） | **[访问凭证](https://open.feishu.cn/document/ukTMukTMukTM/uMTNz4yM1MjLzUzM)（选择其一）** | 商店 | 自建 ---|---|---|---|--- [创建浮动图片](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-float_image/create)
`POST` /open-apis/sheets/v3/spreadsheets/:spreadsheet_token/sheets/:sheet_id/float_images | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [获取浮动图片](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-float_image/get)
`GET` /open-apis/sheets/v3/spreadsheets/:spreadsheet_token/sheets/:sheet_id/float_images/:float_image_id | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet)
查看、评论和下载云空间中所有文件(drive:drive:readonly)
查看、评论和导出电子表格(sheets:spreadsheet:readonly) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [查询浮动图片](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-float_image/query)
`GET` /open-apis/sheets/v3/spreadsheets/:spreadsheet_token/sheets/:sheet_id/float_images/query | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet)
查看、评论和下载云空间中所有文件(drive:drive:readonly)
查看、评论和导出电子表格(sheets:spreadsheet:readonly) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [更新浮动图片](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-float_image/patch)
`PATCH` /open-apis/sheets/v3/spreadsheets/:spreadsheet_token/sheets/:sheet_id/float_images/:float_image_id | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [删除浮动图片](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-float_image/delete)
`DELETE` /open-apis/sheets/v3/spreadsheets/:spreadsheet_token/sheets/:sheet_id/float_images/:float_image_id | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** ### 工作表 - 数据校验 **[方法 (API)](https://open.feishu.cn/document/ukTMukTMukTM/uITNz4iM1MjLyUzM)** | 权限要求（满足任一） | **[访问凭证](https://open.feishu.cn/document/ukTMukTMukTM/uMTNz4yM1MjLzUzM)（选择其一）** | 商店 | 自建 ---|---|---|---|--- [设置下拉列表](https://open.feishu.cn/document/ukTMukTMukTM/uATMzUjLwEzM14CMxMTN/datavalidation/set-dropdown)
`POST` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/dataValidation | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [删除下拉列表设置](https://open.feishu.cn/document/ukTMukTMukTM/uATMzUjLwEzM14CMxMTN/datavalidation/delete-datavalidation)
`DELETE` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/dataValidation | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [更新下拉列表设置](https://open.feishu.cn/document/ukTMukTMukTM/uATMzUjLwEzM14CMxMTN/datavalidation/update-datavalidation)
`PUT` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/dataValidation/:sheetId/:dataValidationId | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [查询下拉列表设置](https://open.feishu.cn/document/ukTMukTMukTM/uATMzUjLwEzM14CMxMTN/datavalidation/query-datavalidation)
`GET` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/dataValidation | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓**