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éthodeType renvoyéBrève description
getDomain()StringRécupère le nom de domaine associé au compte de l'utilisateur.
getEmail()StringRécupère l'adresse e-mail de l'utilisateur.
getName()StringRécupère le nom de l'utilisateur.
getPhotoUrl()StringRécupère l'URL de la photo 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