Class User
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Utilisateur
Représentation d'un utilisateur, adaptée aux scripts.
Méthodes
Méthode | Type renvoyé | Brève description |
getEmail() | String | Récupère l'adresse e-mail de l'utilisateur, le cas échéant. |
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
getEmail()
Récupère l'adresse e-mail de l'utilisateur, le cas échéant. Si les stratégies de sécurité n'autorisent pas l'accès à l'adresse e-mail de l'utilisateur, cette méthode renvoie une chaîne vide. Les circonstances dans lesquelles l'adresse e-mail est disponible varient: par exemple, l'adresse e-mail de l'utilisateur n'est disponible dans aucun contexte permettant l'exécution d'un script sans l'autorisation de cet utilisateur, comme un déclencheur onOpen(e)
ou onEdit(e)
simple, une fonction personnalisée dans Google Sheets ou une application Web déployée pour "s'exécuter en tant que moi" (c'est-à-dire autorisée par le développeur plutôt que par l'utilisateur).
Toutefois, ces restrictions ne s'appliquent généralement pas si le développeur exécute le script lui-même ou appartient au même domaine Google Workspace que l'utilisateur.
// Log the email address of the person running the script.
Logger.log(Session.getActiveUser().getEmail());
Renvois
String
: adresse e-mail de l'utilisateur ou chaîne vide si les règles de sécurité n'autorisent pas l'accès à l'adresse e-mail de l'utilisateur.
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.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/26 (UTC).
[null,null,["Dernière mise à jour le 2025/07/26 (UTC)."],[[["\u003cp\u003eRepresents a user for scripting purposes, providing methods to access user information.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003egetEmail()\u003c/code\u003e retrieves the user's email address if permitted by security policies, returning a blank string otherwise.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003egetUserLoginId()\u003c/code\u003e is deprecated and replaced by \u003ccode\u003egetEmail()\u003c/code\u003e for retrieving the user's email address.\u003c/p\u003e\n"],["\u003cp\u003eAccess to the user's email address might be restricted in certain contexts due to security considerations, such as unauthorized script execution.\u003c/p\u003e\n"]]],[],null,["# Class User\n\nUser\n\nRepresentation of a user, suitable for scripting. \n\n### Methods\n\n| Method | Return type | Brief description |\n|---------------------------|-------------|----------------------------------------------|\n| [getEmail()](#getEmail()) | `String` | Gets the user's email address, if available. |\n\n### Deprecated methods\n\n| Method | Return type | Brief description |\n|---------------------------------------|-------------|--------------------------------|\n| [getUserLoginId()](#getUserLoginId()) | `String` | Gets the user's email address. |\n\nDetailed documentation\n----------------------\n\n### `get``Email()`\n\nGets the user's email address, if available. If security policies do not allow access to the\nuser's email address, this method returns a blank string. The circumstances in which the email\naddress is available vary: for example, the user's email address is not available in any\ncontext that allows a script to run without that user's authorization, like a simple `on``Open(e)` or `on``Edit(e)` trigger, a custom function in Google Sheets, or a web app\ndeployed to \"execute as me\" (that is, authorized by the developer instead of the user).\nHowever, these restrictions generally do not apply if the developer runs the script themselves\nor belongs to the same Google Workspace domain as the user.\n\n```javascript\n// Log the email address of the person running the script.\nLogger.log(Session.getActiveUser().getEmail());\n```\n\n#### Return\n\n\n`String` --- The user's email's address, or a blank string if security policies do not allow access\nto the user's email address.\n\nDeprecated methods\n------------------\n\n### `get``User``Login``Id()`\n\n\n**Deprecated.** As of June 24, 2013, replaced by [getEmail()](#getEmail()).\n\nGets the user's email address.\n\n```javascript\n// Log the email address of the person running the script.\nLogger.log(Session.getActiveUser().getUserLoginId());\n```\n\n#### Return\n\n\n`String` --- The user's email's address."]]