Class User

Utilisateur

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

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 de son compte Google+, ou s'il appartient au même domaine que l'utilisateur exécutant 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()

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|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