服务端 API/云文档/电子表格/开发指南（开发前必读）/电子表格概述 # 电子表格概述 支持通过调用表格 API，完成自动创建表格、读取或编辑工作表等操作。 # 名词解释 ## 表格（Spreadsheet） 表格是承载数据的容器，也提供数据处理和呈现的功能。一个表格可能包含一个或者多个工作表，我们在处理数据时，都是针对某个工作表进行操作的。 每篇文档都有一个 spreadsheetToken 作为唯一标识，每一个工作表都有一个 sheetId 作为唯一标识。 ## spreadsheetToken 以及 sheetId spreadsheetToken 是一个表格的唯一标识，你可以通过以下任一方式获取一个表格的 spreadsheetToken： - 通过表格的 URL 获取：https://sample.larksuite.com/sheets/==shtcnmBA\*****yGehy8== - 通过 [获取文件夹下文档清单 API](https://open.larksuite.com/document/ukTMukTMukTM/uEjNzUjLxYzM14SM2MTN) 的返回值获取表格的 spreadsheetToken

sheetId 是一个工作表的唯一标识，你可以通过以下任一方式获取一个工作表的 sheetId： - 通过表格的 URL 获取：https://sample.larksuite.com/sheets/shtcnmBA\*****yGehy8?sheet===0b\**12== - 通过 [获取表格元数据 API](https://open.larksuite.com/document/ukTMukTMukTM/uETMzUjLxEzM14SMxMTN) 的返回值获取工作表的 sheetId 几乎所有的表格操作方法，需要传入 spreadsheetToken 来指定要操作的表格。 ## Range Range 描述工作表的某个范围。在数据读写中，能帮助用户过滤数据的操作范围。 range 的描述方式为 ==\!<开始位置>:<结束位置>== ，共有 4 种描述方法，分别为： - \!<开始单元格>:<结束单元格> 如：0b\**12!A1:B5 就表示 0b\**12 这个工作表中 A1:B5 的区域，如下图所示： ![image.png](//sf16-sg.larksuitecdn.com/obj/open-platform-opendoc-sg/76498891d78bff326b0bcffe43427fa9_fUFkCG77Vw.png?lazyload=true&width=722&height=484) - \!<开始列>:<结束列>，如：0b\**12!A:B - \!<开始单元格>:<结束列>，如：0b\**12!A1:B - \，区域留空，如：0b\**12，代表这个表格中非空的最大行列范围内的数据 在使用「读取单个范围」或「读取多个范围」等读取表格数据的接口时，上述几种描述方式，表示这个工作表中 A1:B5 的区域，如下图所示： ![image.png](//sf16-sg.larksuitecdn.com/obj/open-platform-opendoc-sg/dca12da354cb99d01c2893283893ae2a_Y9COFAZsea.png?lazyload=true&width=856&height=576) # 方法集合 ## 表格 包含表格创建、获取和更新相关接口。 ### 方法列表 > “商店”代表 [应用商店应用](https://open.larksuite.com/document/home/app-types-introduction/overview)；“自建”代表 [企业自建应用](https://open.larksuite.com/document/home/app-types-introduction/overview) **[方法 (API)](https://open.larksuite.com/document/ukTMukTMukTM/uITNz4iM1MjLyUzM)** | 权限要求（满足任一） | **[访问凭证](https://open.larksuite.com/document/ukTMukTMukTM/uMTNz4yM1MjLzUzM)（选择其一）** | 商店 | 自建 ---|---|---|---|--- [创建表格](https://open.larksuite.com/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.larksuite.com/document/ukTMukTMukTM/uETMzUjLxEzM14SMxMTN)
`GET` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/metainfo | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论和下载云空间中所有文件(drive:drive:readonly)
查看、评论、编辑和管理电子表格(sheets:spreadsheet)
查看、评论和导出电子表格(sheets:spreadsheet:readonly) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [更新表格属性](https://open.larksuite.com/document/ukTMukTMukTM/ucTMzUjL3EzM14yNxMTN)
`PUT` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/properties | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** ## 工作表 包含工作表操作和更新属性相关接口。 ### 方法列表 > “商店”代表 [应用商店应用](https://open.larksuite.com/document/home/app-types-introduction/overview)；“自建”代表 [企业自建应用](https://open.larksuite.com/document/home/app-types-introduction/overview) **[方法 (API)](https://open.larksuite.com/document/ukTMukTMukTM/uITNz4iM1MjLyUzM)** | 权限要求（满足任一） | **[访问凭证](https://open.larksuite.com/document/ukTMukTMukTM/uMTNz4yM1MjLzUzM)（选择其一）** | 商店 | 自建 ---|---|---|---|--- [更新工作表属性](https://open.larksuite.com/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.larksuite.com/document/ukTMukTMukTM/uYTMzUjL2EzM14iNxMTN)
`POST` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/sheets_batch_update | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** ## 工作表 - 条件格式 包含工作表中条件格式创建、删除、获取和更新相关接口。 ### 方法列表 > “商店”代表 [应用商店应用](https://open.larksuite.com/document/home/app-types-introduction/overview)；“自建”代表 [企业自建应用](https://open.larksuite.com/document/home/app-types-introduction/overview) **[方法 (API)](https://open.larksuite.com/document/ukTMukTMukTM/uITNz4iM1MjLyUzM)** | 权限要求（满足任一） | **[访问凭证](https://open.larksuite.com/document/ukTMukTMukTM/uMTNz4yM1MjLzUzM)（选择其一）** | 商店 | 自建 ---|---|---|---|--- [创建条件格式](https://open.larksuite.com/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.larksuite.com/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.larksuite.com/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.larksuite.com/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` | **✓** | **✓** ## 工作表 - 筛选 包含工作表筛选创建、删除、获取和更新相关接口。 ### 方法列表 > “商店”代表 [应用商店应用](https://open.larksuite.com/document/home/app-types-introduction/overview)；“自建”代表 [企业自建应用](https://open.larksuite.com/document/home/app-types-introduction/overview) **[方法 (API)](https://open.larksuite.com/document/ukTMukTMukTM/uITNz4iM1MjLyUzM)** | 权限要求（满足任一） | **[访问凭证](https://open.larksuite.com/document/ukTMukTMukTM/uMTNz4yM1MjLzUzM)（选择其一）** | 商店 | 自建 ---|---|---|---|--- [获取筛选](https://open.larksuite.com/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.larksuite.com/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.larksuite.com/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.larksuite.com/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` | **✓** | **✓** ## 工作表 - 筛选视图 包含工作表筛选视图创建、删除、获取和更新相关接口。 ### 方法列表 > “商店”代表 [应用商店应用](https://open.larksuite.com/document/home/app-types-introduction/overview)；“自建”代表 [企业自建应用](https://open.larksuite.com/document/home/app-types-introduction/overview) **[方法 (API)](https://open.larksuite.com/document/ukTMukTMukTM/uITNz4iM1MjLyUzM)** | 权限要求（满足任一） | **[访问凭证](https://open.larksuite.com/document/ukTMukTMukTM/uMTNz4yM1MjLzUzM)（选择其一）** | 商店 | 自建 ---|---|---|---|--- [删除筛选视图](https://open.larksuite.com/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.larksuite.com/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.larksuite.com/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.larksuite.com/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.larksuite.com/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` | **✓** | **✓** ## 筛选视图 - 筛选条件 包含筛选视图的筛选条件创建、删除、获取、更新和查询相关接口。 ### 方法列表 > “商店”代表 [应用商店应用](https://open.larksuite.com/document/home/app-types-introduction/overview)；“自建”代表 [企业自建应用](https://open.larksuite.com/document/home/app-types-introduction/overview) **[方法 (API)](https://open.larksuite.com/document/ukTMukTMukTM/uITNz4iM1MjLyUzM)** | 权限要求（满足任一） | **[访问凭证](https://open.larksuite.com/document/ukTMukTMukTM/uMTNz4yM1MjLzUzM)（选择其一）** | 商店 | 自建 ---|---|---|---|--- [删除筛选条件](https://open.larksuite.com/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.larksuite.com/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.larksuite.com/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.larksuite.com/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.larksuite.com/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` | **✓** | **✓** ## 工作表 - 行列 包含工作表行列增加、插入、删除、移动和更新相关接口。 ### 方法列表 > “商店”代表 [应用商店应用](https://open.larksuite.com/document/home/app-types-introduction/overview)；“自建”代表 [企业自建应用](https://open.larksuite.com/document/home/app-types-introduction/overview) **[方法 (API)](https://open.larksuite.com/document/ukTMukTMukTM/uITNz4iM1MjLyUzM)** | 权限要求（满足任一） | **[访问凭证](https://open.larksuite.com/document/ukTMukTMukTM/uMTNz4yM1MjLzUzM)（选择其一）** | 商店 | 自建 ---|---|---|---|--- [删除行列](https://open.larksuite.com/document/ukTMukTMukTM/ucjMzUjL3IzM14yNyMTN)
`DELETE` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/dimension_range | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [更新行列](https://open.larksuite.com/document/ukTMukTMukTM/uYjMzUjL2IzM14iNyMTN)
`PUT` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/dimension_range | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [增加行列](https://open.larksuite.com/document/ukTMukTMukTM/uUjMzUjL1IzM14SNyMTN)
`POST` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/dimension_range | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [插入行列](https://open.larksuite.com/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.larksuite.com/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` | **✓** | **✓** ## 行列 - 保护范围 包含行列的保护范围增加、删除、获取和修改相关接口。 ### 方法列表 > “商店”代表 [应用商店应用](https://open.larksuite.com/document/home/app-types-introduction/overview)；“自建”代表 [企业自建应用](https://open.larksuite.com/document/home/app-types-introduction/overview) **[方法 (API)](https://open.larksuite.com/document/ukTMukTMukTM/uITNz4iM1MjLyUzM)** | 权限要求（满足任一） | **[访问凭证](https://open.larksuite.com/document/ukTMukTMukTM/uMTNz4yM1MjLzUzM)（选择其一）** | 商店 | 自建 ---|---|---|---|--- [增加保护范围](https://open.larksuite.com/document/ukTMukTMukTM/ugDNzUjL4QzM14CO0MTN)
`POST` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/protected_dimension | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [获取保护范围](https://open.larksuite.com/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.larksuite.com/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.larksuite.com/document/ukTMukTMukTM/uYTM5YjL2ETO24iNxkjN)
`DELETE` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/protected_range_batch_del | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** ## 工作表 - 数据 包含工作表中单元格数据写入与读取，插入图片，样式设置，单元格合并与拆分，内容查找和替换相关接口。 ### 方法列表 > “商店”代表 [应用商店应用](https://open.larksuite.com/document/home/app-types-introduction/overview)；“自建”代表 [企业自建应用](https://open.larksuite.com/document/home/app-types-introduction/overview) **[方法 (API)](https://open.larksuite.com/document/ukTMukTMukTM/uITNz4iM1MjLyUzM)** | 权限要求（满足任一） | **[访问凭证](https://open.larksuite.com/document/ukTMukTMukTM/uMTNz4yM1MjLzUzM)（选择其一）** | 商店 | 自建 ---|---|---|---|--- [插入数据](https://open.larksuite.com/document/ukTMukTMukTM/uIjMzUjLyIzM14iMyMTN)
`POST` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/values_prepend | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [追加数据](https://open.larksuite.com/document/ukTMukTMukTM/uMjMzUjLzIzM14yMyMTN)
`POST` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/values_append | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [读取单个范围](https://open.larksuite.com/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.larksuite.com/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.larksuite.com/document/ukTMukTMukTM/uAjMzUjLwIzM14CMyMTN)
`PUT` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/values | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [向多个范围写入数据](https://open.larksuite.com/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.larksuite.com/document/ukTMukTMukTM/ukjMzUjL5IzM14SOyMTN)
`PUT` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/style | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [批量设置单元格样式 ](https://open.larksuite.com/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.larksuite.com/document/ukTMukTMukTM/ukDNzUjL5QzM14SO0MTN)
`POST` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/merge_cells | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [拆分单元格](https://open.larksuite.com/document/ukTMukTMukTM/uATNzUjLwUzM14CM1MTN)
`POST` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/unmerge_cells | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [写入图片](https://open.larksuite.com/document/ukTMukTMukTM/uUDNxYjL1QTM24SN0EjN)
`POST` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/values_image | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓** [查找单元格](https://open.larksuite.com/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.larksuite.com/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` | **✓** | **✓** ## 工作表 - 浮动图片 包含工作表浮动图片创建、删除、查询、获取和更新相关接口。 ### 方法列表 > “商店”代表 [应用商店应用](https://open.larksuite.com/document/home/app-types-introduction/overview)；“自建”代表 [企业自建应用](https://open.larksuite.com/document/home/app-types-introduction/overview) **[方法 (API)](https://open.larksuite.com/document/ukTMukTMukTM/uITNz4iM1MjLyUzM)** | 权限要求（满足任一） | **[访问凭证](https://open.larksuite.com/document/ukTMukTMukTM/uMTNz4yM1MjLzUzM)（选择其一）** | 商店 | 自建 ---|---|---|---|--- [创建浮动图片](https://open.larksuite.com/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.larksuite.com/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.larksuite.com/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.larksuite.com/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.larksuite.com/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` | **✓** | **✓** ## 工作表 - 数据校验 包含工作表数据验证设置、删除、查询和更新相关接口。 ### 方法列表 > “商店”代表 [应用商店应用](https://open.larksuite.com/document/home/app-types-introduction/overview)；“自建”代表 [企业自建应用](https://open.larksuite.com/document/home/app-types-introduction/overview) **[方法 (API)](https://open.larksuite.com/document/ukTMukTMukTM/uITNz4iM1MjLyUzM)** | 权限要求（满足任一） | **[访问凭证](https://open.larksuite.com/document/ukTMukTMukTM/uMTNz4yM1MjLzUzM)（选择其一）** | 商店 | 自建 ---|---|---|---|--- [设置下拉列表](https://open.larksuite.com/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.larksuite.com/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.larksuite.com/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.larksuite.com/document/ukTMukTMukTM/uATMzUjLwEzM14CMxMTN/datavalidation/query-datavalidation)
`GET` /open-apis/sheets/v2/spreadsheets/:spreadsheetToken/dataValidation | 查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) | `tenant_access_token`
`user_access_token` | **✓** | **✓**