Class User

Utilisateur

Utilisateur associé à un fichier dans Google Drive. Vous pouvez accéder aux utilisateurs à partir de File.getEditors(), Folder.getViewers() et d'autres méthodes.

// 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());
}

Méthodes

Méthode	Type renvoyé	Brève description
getDomain()	String|null	Obtient le nom de domaine associé au compte de l'utilisateur.
getEmail()	String|null	Obtient l'adresse e-mail de l'utilisateur.
getName()	String|null	Obtient le nom de l'utilisateur.
getPhotoUrl()	String|null	Obtient l'URL de la photo de l'utilisateur.

Méthodes obsolètes

Méthode	Type renvoyé	Brève description
getUserLoginId()	String	Obtient l'adresse e-mail de l'utilisateur.

Documentation détaillée

getDomain()

Obtient le nom de domaine associé au compte de l'utilisateur.

// 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());
}

Renvois

String|null : nom de domaine associé au compte de l'utilisateur

---

getEmail()

Obtient l'adresse e-mail de l'utilisateur. L'adresse e-mail de l'utilisateur n'est disponible que si l'utilisateur a choisi de la partager sur la page des paramètres de son compte Google+ ou s'il appartient au même domaine que l'utilisateur qui exécute le script et que l'administrateur du domaine a autorisé tous les utilisateurs du domaine à voir les adresses e-mail des autres utilisateurs.

// 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());
}

Renvois

String|null : adresse e-mail de l'utilisateur ou chaîne vide si l'adresse e-mail n'est pas disponible

---

getName()

Obtient le nom de l'utilisateur. Cette méthode renvoie null si le nom de l'utilisateur n'est pas disponible.

// 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());
}

Renvois

String|null : nom de l'utilisateur ou null si le nom n'est pas disponible

---

getPhotoUrl()

Obtient l'URL de la photo de l'utilisateur. Cette méthode renvoie null si la photo de l'utilisateur n'est pas disponible.

// 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());
}

Renvois

String|null : URL de la photo de l'utilisateur ou null si la photo n'est pas disponible

Méthodes obsolètes

getUserLoginId()

Obsolète. Depuis le 24 juin 2013, remplacé par getEmail().

Obtient l'adresse e-mail de l'utilisateur.

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

Renvois

String : adresse e-mail de l'utilisateur