第三方应用开发
基础
数据与智能专区
应用接收专区通知
连接微信
客户联系
办公
小程序接入对外收款
第三方应用开发
服务端API
文档
设置文档权限
修改文档查看规则
修改文档查看规则
最后更新:2024/08/21

该接口用于修改文档、表格、智能表格查看规则。

请求方式: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
        }
    ]
}

参数说明

参数类型是否必须说明
docidstring操作的docid
enable_corp_internalbool是否允许企业内成员浏览文档, 有值则覆盖
corp_internal_authuint32企业内成员主动查看文档后获得的权限类型 1:只读 2:读写(目前仅智能表可设置为读写), 有值则覆盖
enable_corp_externaluint32是否允许企业外成员浏览文档, 有值则覆盖
corp_external_authuint32企业外成员主浏览文档后获得的权限类型 1:只读 2:读写(目前仅智能表可设置为读写), 有值则覆盖
corp_internal_approve_only_by_adminbool企业内成员加入文档是否必须由管理员审批,enable_corp_internal为false时,只能为true,有值则覆盖。设置为true之前,文档需要有至少一个管理员。
corp_external_approve_only_by_adminbool企业外成员加入文档是否必须由管理员审批,enable_corp_external和ban_share_external均为false时,该参数只能为true,有值则覆盖。设置为true之前,文档需要有至少一个管理员。
ban_share_externalbool是否禁止文档分享到企业外, 有值则覆盖
update_co_auth_listbool是否更新文档查看权限的特定部门, true时更新特定部门列表
co_auth_listobject[]需要更新文档查看权限特定部门时, 覆盖之前部门, 特别的: 列表为空则清空
departmentiduint64文档查看权限特定部门id
authuint32文档特定部门权限 1:只读 2:读写(目前仅智能表可设置为读写)
typeuint32文档特定部门类型 2:部门, 目前只支持部门

 

权限说明

  • 自建应用需配置到“可调用应用”列表中的应用secret所获取的accesstoken来调用(accesstoken如何获取?
  • 第三方应用需具有“文档”权限
  • 代开发自建应用需具有“文档”权限
  • 只能操作该应用创建的文档

 

返回示例

{
    "errcode": 0,
    "errmsg": "ok"
}

参数说明

参数类型说明
errcodeint32错误码
errmsgstring错误码说明
上一篇获取文档权限信息
下一篇修改文档通知范围及权限
    本节内容
服务端API
基础
数据与智能专区
应用接收专区通知
连接微信
客户联系
办公
小程序接入对外收款
客户端API
小程序
基础
连接微信
办公
WECOM-JSSDK
JS-SDK
基础
连接微信
办公
更新日志
联系我们