飞书开放平台 Server API 文档

主题

电子表格概述 ​

本文档介绍飞书开放平台电子表格能力相关的基本概念、使用限制、接入流程、方法列表等。

接入流程 ​

接入电子表格 OpenAPI 的流程如下图所示。了解更多，参考云文档-概述 的 接入流程 一节。

image.png

鉴权说明 ​

使用 tenant_access_token 访问、操作电子表格资源之前，请确保应用已有电子表格的阅读、编辑、管理等文档权限，否则接口将返回 HTTP 403 或 400 状态码。了解更多，参考开通文档、电子表格等云文档资源权限。

基础概念 ​

电子表格 OpenAPI 中，基础概念为表格（spreadsheet）、工作表（sheet）和范围（range）。

表格 ​

表格是承载数据的容器，提供数据处理、展示、分析的功能。一个表格包含一个或多个工作表。

每个表格都有一个 spreadsheetToken 作为唯一标识。你可通过以下任一方式获取表格的 spreadsheetToken：

Warning 对于知识库中的电子表格，你需调用获取知识空间节点信息接口来获取电子表格的 obj_token。此时，该 obj_token 也是该表格的 spreadsheetToken。

工作表 ​

工作表（sheet）是表格中的单独页面。每个工作表都有自己的行和列，形成一个网格，用于组织和存储数据。

每一个工作表都有唯一的 sheetId 作为标识。你可通过以下任一方式获取工作表的 sheetId：

范围 ​

在工作表中进行读取数据、写入数据、筛选数据等各类操作时，你需要通过 范围 range 参数指定操作数据的范围。range 参数的格式为 <sheetId>!<开始位置>:<结束位置>。其中：

  • sheetId 为工作表的唯一标识，通过获取工作表 获取。
  • <开始位置>:<结束位置> 为工作表中单元格的范围，使用数字表示行索引，字母表示列索引。如 A2:B2 表示该工作表第 2 行的 A 列到 B 列。

range 参数共有 4 种写法，分别为：

range 写法示例描述图示
<sheetId>!<开始单元格>:<结束单元格>0bdf12!A1:B5ID 为 <0bdf12> 的工作表中，从 A1 到 B5 的区域。image.png
<sheetId>!<开始列>:<结束列>0bdf12!A:BID 为 <0bdf12> 的工作表中，从 A 列到 B 列的区域。image.png
<sheetId>!<开始单元格>:<结束列>0bdf12!A2:BID 为 <0bdf12> 的工作表中，从 A2 所在行到结束行的行范围、A 列到 B 列的列范围圈定的区域。image.png
<sheetId>ID 为 <sheetId> 的工作表的所有区域。0bdf12/

使用限制 ​

电子表格整体有如下限制：

  • 单个电子表格中工作表的数量不可超过 300 个
  • 单个工作表中列的数量不可超过 13,000 列（包含空列）
  • 单个工作表中单元格的数量不可超过 5,000,000 个（包含空单元格）
  • 单个单元格不超过 50,000 字符，由于服务端会增加控制字符，因此推荐每个单元格不超过 40,000 字符。
  • 单篇文档中电子表格的数量不可超过 1,500 个

电子表格相关接口有如下频率限制。你也可以在每个接口请求的基本信息中找到接口频率限制信息。

接口限流值
创建表格单租户单应用20次/分钟
修改电子表格属性单租户单应用20次/分钟
获取电子表格信息单租户单应用100次/分钟
操作工作表单租户单应用100次/秒
更新工作表属性单租户单应用100次/秒；单个文档只能串行调用
移动行列单租户单应用100次/分钟
插入数据单租户单应用100次/秒；单个文档只能串行调用
追加数据单租户单应用100次/秒；单个文档只能串行调用
插入行列单租户单应用100次/秒；单个文档只能串行调用
增加行列单租户单应用100次/秒；单个文档只能串行调用
更新行列单租户单应用100次/秒；单个文档只能串行调用
删除行列单租户单应用100次/秒；单个文档只能串行调用
读取单个范围单租户单应用100次/秒
读取多个范围单租户单应用100次/秒
向单个范围写入数据单租户单应用100次/秒；单个文档只能串行调用
向多个范围写入数据单租户单应用100次/秒；单个文档只能串行调用
设置单元格样式单租户单应用100次/秒；单个文档只能串行调用
批量设置单元格样式单租户单应用100次/秒；单个文档只能串行调用
合并单元格单租户单应用100次/秒；单个文档只能串行调用
拆分单元格单租户单应用100次/秒；单个文档只能串行调用
写入图片单租户单应用100次/秒；单个文档只能串行调用
查找单元格单租户单应用100次/分钟
替换单元格单租户单应用20次/分钟
创建条件格式单租户单应用100次/秒；单个文档只能串行调用
获取条件格式单租户单应用100次/秒；单个文档只能串行调用
更新条件格式单租户单应用100次/秒；单个文档只能串行调用
删除条件格式单租户单应用100次/秒；单个文档只能串行调用
增加保护范围单租户单应用100次/秒；单个文档只能串行调用
获取保护范围单租户单应用100次/秒；单个文档只能串行调用
修改保护范围单租户单应用100次/秒；单个文档只能串行调用
删除保护范围单租户单应用100次/秒；单个文档只能串行调用
设置下拉列表单租户单应用100次/秒；单个文档只能串行调用
删除下拉列表设置单租户单应用100次/秒；单个文档只能串行调用
更新下拉列表设置单租户单应用100次/秒；单个文档只能串行调用
查询下拉列表设置单租户单应用100次/秒；单个文档只能串行调用
获取筛选单租户单应用100次/分钟
创建筛选单租户单应用20次/分钟
更新筛选单租户单应用20次/分钟
删除筛选单租户单应用100次/分钟
创建筛选视图单租户单应用100次/分钟
获取筛选视图单租户单应用100次/分钟
查询筛选视图单租户单应用100次/分钟
更新筛选视图单租户单应用100次/分钟
删除筛选视图单租户单应用100次/分钟
创建筛选条件单租户单应用100次/分钟
获取筛选条件单租户单应用100次/分钟
查询筛选条件单租户单应用100次/分钟
更新筛选条件单租户单应用100次/分钟
删除筛选条件单租户单应用100次/分钟
创建浮动图片单租户单应用100次/分钟
获取浮动图片单租户单应用100次/分钟
查询浮动图片单租户单应用100次/分钟
更新浮动图片单租户单应用100次/分钟
删除浮动图片单租户单应用100次/分钟

方法列表 ​

以下为电子表格的方法列表。其中，“商店”代表应用商店应用；“自建”代表企业自建应用，了解更多应用相关信息，参考应用类型简介。了解调用服务端 API 的流程，参考流程概述。

表格 ​

方法 (API)权限要求（满足任一）访问凭证（选择其一）商店自建
[创建电子表格](https://open.larkoffice.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.larkoffice.com/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.larkoffice.com/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.larkoffice.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.larkoffice.com/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.larkoffice.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.larkoffice.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.larkoffice.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.larkoffice.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✓✓

工作表 - 筛选 ​

方法 (API)权限要求（满足任一）访问凭证（选择其一）商店自建
[获取筛选](https://open.larkoffice.com/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter/get) GET/open-apis/sheets/v3/spreadsheets/:spreadsheet_token/sheets/:sheet_id/filter sheets:spreadsheet $$$sheets.v3.scope.sheets.v3.scope.sheets:spreadsheet.desc.desc$$$ sheets:spreadsheet:readonly $$$sheets.v3.scope.sheets.v3.scope.sheets:spreadsheet:readonly.desc.desc$$$ drive:drive $$$sheets.v3.scope.sheets.v3.scope.drive:drive.desc.desc$$$ drive:drive:readonly $$$sheets.v3.scope.sheets.v3.scope.drive:drive:readonly.desc.desc$$$tenant_access_token user_access_token✓✓
[创建筛选](https://open.larkoffice.com/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter/create) POST/open-apis/sheets/v3/spreadsheets/:spreadsheet_token/sheets/:sheet_id/filter sheets:spreadsheet $$$sheets.v3.scope.sheets.v3.scope.sheets:spreadsheet.desc.desc$$$ drive:drive $$$sheets.v3.scope.sheets.v3.scope.drive:drive.desc.desc$$$tenant_access_token user_access_token✓✓
[更新筛选](https://open.larkoffice.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.larkoffice.com/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet-filter/delete) DELETE/open-apis/sheets/v3/spreadsheets/:spreadsheet_token/sheets/:sheet_id/filter sheets:spreadsheet $$$sheets.v3.scope.sheets.v3.scope.sheets:spreadsheet.desc.desc$$$ drive:drive $$$sheets.v3.scope.sheets.v3.scope.drive:drive.desc.desc$$$tenant_access_token user_access_token✓✓

工作表 - 筛选视图 ​

方法 (API)权限要求（满足任一）访问凭证（选择其一）商店自建
[删除筛选视图](https://open.larkoffice.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 drive:drive $$$sheets.v3.scope.sheets.v3.scope.drive:drive.desc.desc$$$ sheets:spreadsheet $$$sheets.v3.scope.sheets.v3.scope.sheets:spreadsheet.desc.desc$$$tenant_access_token user_access_token✓✓
[更新筛选视图](https://open.larkoffice.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:spreadsheet $$$sheets.v3.scope.sheets.v3.scope.sheets:spreadsheet.desc.desc$$$ drive:drive $$$sheets.v3.scope.sheets.v3.scope.drive:drive.desc.desc$$$tenant_access_token user_access_token✓✓
[查询筛选视图](https://open.larkoffice.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:spreadsheet:readonly $$$sheets.v3.scope.sheets.v3.scope.sheets:spreadsheet:readonly.desc.desc$$$ drive:drive $$$sheets.v3.scope.sheets.v3.scope.drive:drive.desc.desc$$$ drive:drive:readonly $$$sheets.v3.scope.sheets.v3.scope.drive:drive:readonly.desc.desc$$$ sheets:spreadsheet $$$sheets.v3.scope.sheets.v3.scope.sheets:spreadsheet.desc.desc$$$tenant_access_token user_access_token✓✓
[获取筛选视图](https://open.larkoffice.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:spreadsheet $$$sheets.v3.scope.sheets.v3.scope.sheets:spreadsheet.desc.desc$$$ sheets:spreadsheet:readonly $$$sheets.v3.scope.sheets.v3.scope.sheets:spreadsheet:readonly.desc.desc$$$ drive:drive $$$sheets.v3.scope.sheets.v3.scope.drive:drive.desc.desc$$$ drive:drive:readonly $$$sheets.v3.scope.sheets.v3.scope.drive:drive:readonly.desc.desc$$$tenant_access_token user_access_token✓✓
[创建筛选视图](https://open.larkoffice.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:spreadsheet $$$sheets.v3.scope.sheets.v3.scope.sheets:spreadsheet.desc.desc$$$ drive:drive $$$sheets.v3.scope.sheets.v3.scope.drive:drive.desc.desc$$$tenant_access_token user_access_token✓✓

筛选视图 - 筛选条件 ​

方法 (API)权限要求（满足任一）访问凭证（选择其一）商店自建
[删除筛选条件](https://open.larkoffice.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:spreadsheet $$$sheets.v3.scope.sheets.v3.scope.sheets:spreadsheet.desc.desc$$$ drive:drive $$$sheets.v3.scope.sheets.v3.scope.drive:drive.desc.desc$$$tenant_access_token user_access_token✓✓
[更新筛选条件](https://open.larkoffice.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:spreadsheet $$$sheets.v3.scope.sheets.v3.scope.sheets:spreadsheet.desc.desc$$$ drive:drive $$$sheets.v3.scope.sheets.v3.scope.drive:drive.desc.desc$$$tenant_access_token user_access_token✓✓
[查询筛选条件](https://open.larkoffice.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:spreadsheet $$$sheets.v3.scope.sheets.v3.scope.sheets:spreadsheet.desc.desc$$$ sheets:spreadsheet:readonly $$$sheets.v3.scope.sheets.v3.scope.sheets:spreadsheet:readonly.desc.desc$$$ drive:drive $$$sheets.v3.scope.sheets.v3.scope.drive:drive.desc.desc$$$ drive:drive:readonly $$$sheets.v3.scope.sheets.v3.scope.drive:drive:readonly.desc.desc$$$tenant_access_token user_access_token✓✓
[获取筛选条件](https://open.larkoffice.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 drive:drive:readonly $$$sheets.v3.scope.sheets.v3.scope.drive:drive:readonly.desc.desc$$$ sheets:spreadsheet $$$sheets.v3.scope.sheets.v3.scope.sheets:spreadsheet.desc.desc$$$ sheets:spreadsheet:readonly $$$sheets.v3.scope.sheets.v3.scope.sheets:spreadsheet:readonly.desc.desc$$$ drive:drive $$$sheets.v3.scope.sheets.v3.scope.drive:drive.desc.desc$$$tenant_access_token user_access_token✓✓
[创建筛选条件](https://open.larkoffice.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:spreadsheet $$$sheets.v3.scope.sheets.v3.scope.sheets:spreadsheet.desc.desc$$$ drive:drive $$$sheets.v3.scope.sheets.v3.scope.drive:drive.desc.desc$$$tenant_access_token user_access_token✓✓

工作表 - 行列 ​

方法 (API)权限要求（满足任一）访问凭证（选择其一）商店自建
[删除行列](https://open.larkoffice.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.larkoffice.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.larkoffice.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.larkoffice.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.larkoffice.com/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet/move_dimension) POST/open-apis/sheets/v3/spreadsheets/:spreadsheet_token/sheets/:sheet_id/move_dimension drive:drive $$$sheets.v3.scope.sheets.v3.scope.drive:drive.desc.desc$$$ sheets:spreadsheet $$$sheets.v3.scope.sheets.v3.scope.sheets:spreadsheet.desc.desc$$$tenant_access_token user_access_token✓✓

行列 - 保护范围 ​

方法 (API)权限要求（满足任一）访问凭证（选择其一）商店自建
[增加保护范围](https://open.larkoffice.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.larkoffice.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.larkoffice.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.larkoffice.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✓✓

工作表 - 数据 ​

方法 (API)权限要求（满足任一）访问凭证（选择其一）商店自建
[插入数据](https://open.larkoffice.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.larkoffice.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.larkoffice.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.larkoffice.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.larkoffice.com/document/ukTMukTMukTM/uAjMzUjLwIzM14CMyMTN) PUT/open-apis/sheets/v2/spreadsheets/:spreadsheetToken/values drive:drive 查看、评论、编辑和管理云空间中所有文件 sheets:spreadsheet 查看、评论、编辑和管理电子表格tenant_access_token user_access_token✓✓
[向多个范围写入数据](https://open.larkoffice.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.larkoffice.com/document/ukTMukTMukTM/ukjMzUjL5IzM14SOyMTN) PUT/open-apis/sheets/v2/spreadsheets/:spreadsheetToken/style drive:drive 查看、评论、编辑和管理云空间中所有文件 sheets:spreadsheet 查看、评论、编辑和管理电子表格tenant_access_token user_access_token✓✓
[批量设置单元格样式 ](https://open.larkoffice.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.larkoffice.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.larkoffice.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.larkoffice.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.larkoffice.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.larkoffice.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✓✓

工作表 - 浮动图片 ​

方法 (API)权限要求（满足任一）访问凭证（选择其一）商店自建
[创建浮动图片](https://open.larkoffice.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.larkoffice.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.larkoffice.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.larkoffice.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.larkoffice.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✓✓

工作表 - 数据校验 ​

方法 (API)权限要求（满足任一）访问凭证（选择其一）商店自建
[设置下拉列表](https://open.larkoffice.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.larkoffice.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.larkoffice.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.larkoffice.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✓✓

内容来源：飞书开放平台 · 自动爬取整理

本镜像仅供学习与查阅，文档版权归飞书所有