该接口用于修改文档、表格、智能表格查看规则。
请求方式:POST(HTTPS)
请求地址: https://qyapi.weixin.qq.com/cgi-bin/wedoc/mod_doc_join_rule?access_token=ACCESS_TOKEN
请求包体
{
"docid":"DOCID",
"enable_corp_internal":true,
"corp_internal_auth":1,
"enable_corp_external":true,
"corp_external_auth":1,
"corp_internal_approve_only_by_admin":true,
"corp_external_approve_only_by_admin":true,
"ban_share_external":false,
"update_co_auth_list":true,
"co_auth_list":[
{
"departmentid":1,
"auth":1,
"type":2
}
]
}
参数说明
参数 | 类型 | 是否必须 | 说明 |
---|---|---|---|
docid | string | 是 | 操作的docid |
enable_corp_internal | bool | 否 | 是否允许企业内成员浏览文档, 有值则覆盖 |
corp_internal_auth | uint32 | 否 | 企业内成员主动查看文档后获得的权限类型 1:只读 2:读写(目前仅智能表可设置为读写), 有值则覆盖 |
enable_corp_external | uint32 | 否 | 是否允许企业外成员浏览文档, 有值则覆盖 |
corp_external_auth | uint32 | 否 | 企业外成员主浏览文档后获得的权限类型 1:只读 2:读写(目前仅智能表可设置为读写), 有值则覆盖 |
corp_internal_approve_only_by_admin | bool | 否 | 企业内成员加入文档是否必须由管理员审批,enable_corp_internal为false时,只能为true,有值则覆盖。设置为true之前,文档需要有至少一个管理员。 |
corp_external_approve_only_by_admin | bool | 否 | 企业外成员加入文档是否必须由管理员审批,enable_corp_external和ban_share_external均为false时,该参数只能为true,有值则覆盖。设置为true之前,文档需要有至少一个管理员。 |
ban_share_external | bool | 否 | 是否禁止文档分享到企业外, 有值则覆盖 |
update_co_auth_list | bool | 否 | 是否更新文档查看权限的特定部门, true时更新特定部门列表 |
co_auth_list | object[] | 否 | 需要更新文档查看权限特定部门时, 覆盖之前部门, 特别的: 列表为空则清空 |
departmentid | uint64 | 否 | 文档查看权限特定部门id |
auth | uint32 | 否 | 文档特定部门权限 1:只读 2:读写(目前仅智能表可设置为读写) |
type | uint32 | 否 | 文档特定部门类型 2:部门, 目前只支持部门 |
权限说明
返回示例
{
"errcode": 0,
"errmsg": "ok"
}
参数说明
参数 | 类型 | 说明 |
---|---|---|
errcode | int32 | 错误码 |
errmsg | string | 错误码说明 |