如何通过 API 向某人授予 Smartsheet 访问权限？答案

【问题标题】：How to give a Smartsheet access to someone with API?如何通过 API 向某人授予 Smartsheet 访问权限？
【发布时间】：2021-10-14 08:53:15
【问题描述】：

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

用户已经有一个 smartsheet 帐户。

是否有允许执行此操作的 smartsheet 端点？

谢谢

【问题讨论】：

【解决方案1】：

您要查找的操作是Share Sheet。

以下示例请求授予使用电子邮件地址 jane.doe@test.comEDITOR 注册的 Smartsheet 用户（写入）访问请求 URL 中 sheetId 指定的工作表的权限。

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

几点说明：

默认情况下，共享工作表操作不会向用户发送电子邮件通知他们已被授予访问工作表的权限。如果您希望它向他们发送电子邮件，则需要在请求 URL 上指定查询字符串参数/值 sendEmail=true，并在请求正文中指定 message 和 subject 属性。有关详细信息，请参阅 API 文档中的 Share Sheet。
如果您希望用户能够与其他人共享工作表，您需要指定 EDITOR_SHARE 作为访问级别（而不是 EDITOR）。有关各种权限的详细信息，请参阅 API 文档中的 Access Levels。

【讨论】：