修改文档通知范围及权限

POST

https://qyapi.weixin.qq.com/cgi-bin/wedoc/mod_doc_member

该接口用于修改文档通知范围列表，可以新增文档通知范围并设置权限、修改已有范围的权限以及删除文档通知范围内的人员

权限说明

第三方应用需具有“文档”权限
代开发自建应用需具有“文档”权限
只能操作该应用创建的文档

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://qyapi.weixin.qq.com/cgi-bin/wedoc/mod_doc_member' \
--header 'Content-Type: application/json' \
--data-raw '{
    "docid":"DOCID",
    "update_file_member_list":[
        {
            "type":1,
            "auth":7,
            "userid":"USERID1"
        }
     ],
    "del_file_member_list":[
        {
            "type":1,
            "userid":"USERID2"
        },
        {
            "type":1,
            "tmp_external_userid":"TMP_EXTERNAL_USERID2"
        }
   ]
}'

响应示例

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

请求参数

Query 参数

access_token

string

可选

示例值:

ACCESS_TOKEN

Body 参数application/json

docid

string

操作的文档id

必需

update_file_member_list

array [object {3}]

必需

更新文档通知范围的列表, 批次大小最大100

type

integer

必需

文档通知范围的类型 1:人文档通知范围仅支持按人配置

auth

integer

必需

文档通知范围内人员获得的权限 1:只读权限, 7:管理员权限，文档管理员最多三个

userid

string

企业内成员的ID

可选

del_file_member_list

array [object {3}]

可选

删除的文档通知范围列表，批次大小最大一百

type

integer

必需

文档通知范围的类型 1:人文档通知范围仅支持按人配置

userid

string

企业内成员的ID

可选

tmp_external_userid

string

可选

外部用户临时id。同一个用户在不同的文档中返回的该id不一致。

示例

返回响应

🟢200成功

application/json

Body

errcode

integer

错误码

必需

errmsg

string

错误码说明

必需

修改文档查看规则

修改文档安全设置