如何向拥有 API 的人授予 Smartsheet 访问权限?

How to give a Smartsheet access to someone with API?

使用 PHP,我使用 smartsheet API 从 excel 文件创建了一个 smartsheet。到目前为止一切正常。但我还想向特定用户授予对新智能表的访问权限,以允许他从浏览器打开它。

用户已有smartsheet账户。

是否有允许完成此操作的智能表端点?

谢谢

您要查找的操作是Share Sheet

以下示例请求授予使用电子邮件地址 jane.doe@test.com EDITOR(写入)注册的 Smartsheet 用户访问 sheet在请求 URL.

中由 sheetId 指定
POST /sheets/{sheetId}/shares
[
  {
    "email": "jane.doe@test.com", 
    "accessLevel": "EDITOR"
  }
]

一些注意事项:

  • 默认情况下,Share Sheet 操作不会向用户发送电子邮件通知他们已获得访问权限到 sheet。如果您希望它向他们发送电子邮件,您需要在请求 URL 上指定查询字符串 parameter/value sendEmail=true,并指定 messagesubject 请求正文中的属性。有关详细信息,请参阅 API 文档中的 Share Sheet

  • 如果您希望用户能够与其他人共享 sheet,您需要指定 EDITOR_SHARE作为访问级别(而不是 EDITOR)。有关各种权限的详细信息,请参阅 API 文档中的 Access Levels