概述 - 飞书 API

多维表格的 所有者或者有可管理权限 的用户可通过 API 设置高级权限，管理高级权限的协作者，针对每个数据表设置谁可以查看、编辑指定的行，或是指定可以编辑的列。使用前请阅读使用多维表格高级权限。

高级权限接口分为 自定义角色 和 协作者 两部分。

注意事项

调用高级权限的接口前，请先确保多维表格已开启高级权限。可以通过更新多维表格元数据开启高级权限。

飞书文档、飞书表格、知识库中的多维表格不支持开启高级权限。

开启高级权限有延迟，开启高级权限后立即调用高级权限的接口时遇到 OperationTypeError 的报错请重试。

高级权限的协作者与云文档权限协作者为不同权限身份，添加高级权限协作者之后，为保证文档权限设置正常，建议再通过增加协作者权限接口新增文档权限。

开启高级权限后，首先设置自定义角色，完成设置后可管理自定义的协作者。

暂不支持仪表盘权限

“商店”代表应用商店应用；“自建”代表企业自建应用。

	方法 (API)	权限要求（满足任一）		访问凭证（选择其一）
列出自定义角色`GET` /open-apis/bitable/v1/apps/:app_token/roles	查看、评论、编辑和管理多维表格	tenant_access_tokenuser_access_token	✓	✓
新增自定义角色`POST` /open-apis/bitable/v1/apps/:app_token/roles/:role_id	查看、评论、编辑和管理多维表格	tenant_access_tokenuser_access_token	✓	✓
更新自定义角色`PUT` /open-apis/bitable/v1/apps/:app_token/roles/:role_id	查看、评论、编辑和管理多维表格	tenant_access_tokenuser_access_token	✓	✓
删除自定义角色`DELETE` /open-apis/bitable/v1/apps/:app_token/roles/:role_id	查看、评论、编辑和管理多维表格	tenant_access_tokenuser_access_token	✓	✓

“商店”代表应用商店应用；“自建”代表企业自建应用。

	方法 (API)	权限要求（满足任一）		访问凭证（选择其一）
列出协作者`GET` /open-apis/bitable/v1/apps/:app_token/roles/:role_id/members	查看、评论、编辑和管理多维表格	tenant_access_tokenuser_access_token	✓	✓
新增协作者`POST` /open-apis/bitable/v1/apps/:app_token/roles/:role_id/members	查看、评论、编辑和管理多维表格	tenant_access_tokenuser_access_token	✓	✓
删除协作者`DELETE` /open-apis/bitable/v1/apps/:app_token/roles/:role_id/members/:member_id	查看、评论、编辑和管理多维表格	tenant_access_tokenuser_access_token	✓	✓