更新文档公共设置

该接口用于根据 filetoken 更新文档的公共设置。

curl --location --request PATCH 'https://open.feishu.cn/open-apis/drive/v1/permissions/doccnBKgoMyY5OMbUG6FioTXuBe/public?type=doc' \ --header 'Authorization;' \ --header 'Content-Type: application/json' \ --data-raw ''

{ "code": 0, "msg": "success", "data": { "permission_public": { "external_access": true, "security_entity": "anyone_can_view", "comment_entity": "anyone_can_view", "share_entity": "anyone", "link_share_entity": "tenant_readable", "invite_external": true } } }

请求参数

Path 参数

token

文件的 token

必需

示例值:

doccnBKgoMyY5OMbUG6FioTXuBe

Query 参数

type

权限客体类型

必需

示例值:

doc

Header 参数

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

Content-Type

string

必需

固定值："application/json; charset=utf-8"

默认值:

application/json; charset=utf-8

Body 参数application/json

external_access

boolean

必需

是否允许分享到租户外开关示例值：true

security_entity

string

必需

可创建副本/打印/导出/复制设置示例值："anyone_can_view" 可选值有： anyone_can_view：所有可访问此文档的用户 anyone_can_edit：有编辑权限的用户

comment_entity

string

必需

可评论设置示例值："anyone_can_view" 可选值有： anyone_can_view：所有可访问此文档的用户 anyone_can_edit：有编辑权限的用户

share_entity

string

必需

谁可以添加和管理协作者示例值："anyone" 可选值有： anyone：所有可阅读或编辑此文档的用户 same_tenant：组织内所有可阅读或编辑此文档的用户 only_full_access：只有所有权限者可以

link_share_entity

string

必需

链接共享示例值："tenant_readable" 可选值有： tenant_readable：组织内获得链接的人可阅读 tenant_editable：组织内获得链接的人可编辑 anyone_readable：获得链接的任何人可阅读（仅external_access=true时有效） anyone_editable：获得链接的任何人可编辑（仅external_access=true时有效） closed：关闭链接分享

invite_external

boolean

必需

非所有权限者/所有者是否允许邀请外部人示例值：true

示例

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

必需

permission_public

object

必需

本次更新后的文档公共设置

更新文档公共设置

请求参数

返回响应