# 更新文档公共设置

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

基本 |  
---|---
HTTP URL | https://open.feishu.cn/open-apis/drive/permission/public/update
HTTP Method | POST
权限要求<br>**调用该 API 所需的权限。开启其中任意一项权限即可调用**<br>开启任一权限即可 | 查看、评论、编辑和管理云空间中所有文件<br>上传、下载文件到云空间<br>查看、评论、编辑和管理文档<br>查看、评论、编辑和管理表格

### 请求头

名称 | 类型 | 必填 | 描述
---|---|---|---
Authorization | string | 是 | `user_access_token` 或 `tenant_access_token`<br>**值格式**："Bearer `access_token`"<br>**示例值**："Bearer u-7f1bcd13fc57d46bac21793a18e560"<br>[了解更多：获取与使用access_token](https://open.feishu.cn/document/ukTMukTMukTM/uMTNz4yM1MjLzUzM)
Content-Type | string | 是 | **固定值**："application/json; charset=utf-8"

使用 `tenant_access_token` 前，请确保该应用是文档的所有者，否则会报无权限错误。

<br>

### 请求体
|参数|类型|必须|说明|
|--|-----|--|----|
|token|string|是|文件的 token，获取方式见 [对接前说明](https://open.feishu.cn/document/ukTMukTMukTM/uczNzUjL3czM14yN3MTN)的第 4 项|
|type|string|是|文档类型  "doc"  or  "sheet"|
|copy_print_export_status|bool|否|可创建副本/打印/导出/复制设置（不传则保持原值）：<br>true - 所有可访问此文档的用户<br>false - 有编辑权限的用户|
|comment|bool|否|可评论设置（不传则保持原值）：<br>true - 所有可访问此文档的用户<br>false - 有编辑权限的用户|
|tenant_shareable|bool|否|租户内用户是否有共享权限（不传则保持原值）|
|link_share_entity|string|否|链接共享（不传则保持原值）：<br>"tenant_readable" - 组织内获得链接的人可阅读<br>"tenant_editable" - 组织内获得链接的人可编辑<br>"anyone_readable" - 获得链接的任何人可阅读<br>"anyone_editable" - 获得链接的任何人可编辑| 请求 body |
|external_access|bool|否|是否允许分享到租户外开关（不传则保持原值）|
|invite_external|bool|否|非owner是否允许邀请外部人（不传则保持原值）| 
### 请求体示例
```json
{
	"token": "doccnBKgoMyY5OMbUG6FioTXuBe",
	"type": "doc",
	"copy_print_export_status": false,
	"comment": false,
	"tenant_shareable":false,
	"link_share_entity":"tenant_editable",
	"external_access":false,
	"invite_external":false
}
```
## 响应

### 响应体
|参数|说明|
|--|--|
|is_success|是否成功|
### 响应体示例
```json
{
    "code": 0,
    "data": {
        "is_success": true
    },
    "msg": "Success"
}
```
### 错误码

具体可参考：[服务端错误码说明](https://open.feishu.cn/document/ukTMukTMukTM/ugjM14COyUjL4ITN)