Class User

Utilisateur

Utilisateur associé à un fichier dans Google Drive. Les utilisateurs peuvent être accessibles à 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	Récupère le nom de domaine associé au compte de l'utilisateur.
getEmail()	String	Récupère l'adresse e-mail de l'utilisateur.
getName()	String	Récupère le nom de l'utilisateur.
getPhotoUrl()	String	Récupère l'URL de la photo de l'utilisateur.

Méthodes obsolètes

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

Documentation détaillée

getDomain()

Récupère 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 : nom de domaine associé au compte de l'utilisateur

---

getEmail()

Récupère 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 depuis la page des paramètres du 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 : adresse e-mail de l'utilisateur ou chaîne vide si l'adresse e-mail n'est pas disponible

---

getName()

Récupère 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 : nom de l'utilisateur ou null si le nom n'est pas disponible

---

getPhotoUrl()

Récupère 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 : URL de la photo de l'utilisateur, ou null si la photo n'est pas disponible

Méthodes obsolètes

getUserLoginId()

Obsolète. Remplacement par getEmail() depuis le 24 juin 2013.

Récupère 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.