获取文件权限

接口说明

本接口用于查看文档、共享文件夹、空间权限。

请求格式

描述	定义
Path	/openapi/drive/v3/files/{fileId}/permissions
Method	GET
Content-Type	application/json; charset=utf-8

请求头部

详见Headers。

请求参数

路径参数

参数名	类型	必选	描述
fileId	string	是	文件 Id，文件的唯一标识

请求示例

curl --location --request GET 'https://{domain}/openapi/drive/v3/files/DQXpDYVZaSXBKYmxX/permissions' \
--header 'Access-Token: ACCESS_TOKEN' \
--header 'Client-Id: CLIENT_ID' \

响应参数

响应体

接口请求成功则会返回文件权限设置(Permission)。

响应示例

{
    "accessPolicy": "REVIEWED_BY_ADMIN",
    "externalAccessPolicy": "PRIVATE",
    "members": [
        {
            "user": {
                "id": "user1",
                "type": "OAUTH_USER",
                "displayName": "user1Name",
                "avatar": "http://test1.png"
            },
            "role": "SUPER_ADMIN"
        },
        {
            "user": {
                "id": "user2",
                "type": "OAUTH_USER",
                "displayName": "user2Name",
                "avatar": "http://test2.svg"
            },
            "role": "VIEWER"
        },
        {
            "user": {
                "id": "user3",
                "type": "OAUTH_USER",
                "displayName": "user3Name",
                "avatar": "http://test3.svg"
            },
            "role": "VIEWER"
        }
    ],
    "setting": {
        "viewerCanCopyPrint": true,
        "viewerCanComment": true
    }
}

错误码

查询通用错误码