如何通过Smartsheet API为指定用户授予Smartsheet访问权限
Smartsheet 工作表授权API使用说明
有可直接实现该需求的官方API端点,你可以通过Smartsheet的工作表共享接口为指定用户分配访问权限:
核心接口信息
- 接口请求方法与路径:
POST /sheets/{sheetId}/shares,路径中的{sheetId}替换为你新创建的Smartsheet工作表ID即可 - 请求体必填参数:
email:待授权用户绑定的Smartsheet账号邮箱accessLevel:授权的权限等级,常用可选值包括VIEWER(仅查看)、EDITOR(可编辑)、EDITOR_SHARE(可编辑且可再共享权限)、ADMIN(工作表管理员权限),可根据你的业务需求选择对应值
- 可选参数
sendEmail:布尔类型,设置为true时系统会自动向目标用户发送授权通知邮件,邮件内附工作表的直接访问链接
PHP调用示例
如果使用Smartsheet官方PHP SDK,调用代码参考如下:
// 初始化Smartsheet客户端 $smartsheetClient = new Smartsheet\Smartsheet([ 'accessToken' => '你的Smartsheet API访问令牌' ]); // 构造共享权限参数 $shareConfig = new Smartsheet\Objects\Share(); $shareConfig->setEmail('target_user@example.com'); // 替换为目标用户的账号邮箱 $shareConfig->setAccessLevel('VIEWER'); // 替换为你要授予的权限等级 // 调用授权接口,$createdSheetId为你新建的工作表ID $response = $smartsheetClient->sheets()->createShare($createdSheetId, $shareConfig);
如果你没有使用官方SDK,自行封装HTTP请求时,需要在请求头中携带Authorization: Bearer 你的API访问令牌,并将Content-Type设置为application/json。接口调用成功后,目标用户使用自己的Smartsheet账号登录后即可直接访问该工作表。
内容的提问来源于stack exchange,提问作者Moustakime KIFIA
相关产品推荐
相关产品推荐

