Class User

用户

用户的表示法，适合脚本化。

方法

方法	返回类型	简介
getEmail()	String	获取用户的电子邮件地址（如果有）。

已弃用的方法

方法	返回类型	简介
getUserLoginId()	String	获取用户的电子邮件地址。

详细文档

getEmail()

获取用户的电子邮件地址（如果有）。如果安全政策不允许访问用户的电子邮件地址，此方法会返回空字符串。电子邮件地址可供使用的情形各不相同：例如，在允许脚本在无需用户授权的情况下运行的任何情境中（例如简单的 onOpen(e) 或 onEdit(e) 触发器、Google 表格中的自定义函数，或部署为“以我的身份执行”（即由开发者而非用户授权）的 Web 应用），用户的电子邮件地址都不可用。不过，如果开发者自行运行脚本或与用户属于同一 Google Workspace 网域，这些限制通常不适用。

// Log the email address of the person running the script.
Logger.log(Session.getActiveUser().getEmail());

返回

String - 用户的电子邮件地址，如果安全政策不允许访问用户的电子邮件地址，则为空字符串。

已弃用的方法

getUserLoginId()

已弃用。自 2013 年 6 月 24 日起，已被 getEmail() 替换。

获取用户的电子邮件地址。

// Log the email address of the person running the script.
Logger.log(Session.getActiveUser().getUserLoginId());

返回

String - 用户的电子邮件地址。