Class User

用户

与 Google 云端硬盘中的文件关联的用户。您可以通过 File.getEditors()、Folder.getViewers() 和其他方法访问用户。

// Log the email address of all users who have edit access to a file.
const file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
const editors = file.getEditors();
for (let i = 0; i < editors.length; i++) {
  Logger.log(editors[i].getEmail());
}

方法

方法	返回类型	简介
getDomain()	String	获取与用户账号关联的域名。
getEmail()	String	获取用户的电子邮件地址。
getName()	String	获取用户的姓名。
getPhotoUrl()	String	获取用户照片的网址。

已弃用的方法

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

详细文档

getDomain()

获取与用户账号关联的域名。

// Log the domain names associated with all users who have edit access to a
// file.
const file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
const editors = file.getEditors();
for (let i = 0; i < editors.length; i++) {
  Logger.log(editors[i].getDomain());
}

返回

String - 与用户账号关联的域名

---

getEmail()

获取用户的电子邮件地址。只有在以下情况下，系统才会提供用户的电子邮件地址：用户已选择在 Google+ 账号设置页面中分享该地址；或者，用户与运行脚本的用户属于同一网域，并且网域管理员已允许网域中的所有用户查看其他用户的电子邮件地址。

// Log the email address of all users who have edit access to a file.
const file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
const editors = file.getEditors();
for (let i = 0; i < editors.length; i++) {
  Logger.log(editors[i].getEmail());
}

返回

String - 用户的电子邮件地址，如果没有电子邮件地址，则为空字符串

---

getName()

获取用户的姓名。如果用户的姓名不可用，此方法会返回 null。

// Log the names of all users who have edit access to a file.
const file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
const editors = file.getEditors();
for (let i = 0; i < editors.length; i++) {
  Logger.log(editors[i].getName());
}

返回

String - 用户的姓名，如果没有姓名，则为 null

---

getPhotoUrl()

获取用户照片的网址。如果用户没有照片，此方法会返回 null。

// Log the URLs for the photos of all users who have edit access to a file.
const file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
const editors = file.getEditors();
for (let i = 0; i < editors.length; i++) {
  Logger.log(editors[i].getPhotoUrl());
}

返回

String - 用户照片的网址，如果没有照片，则为 null

已弃用的方法

getUserLoginId()

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

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

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

返回

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