AI-generated Key Takeaways
-
The
Userobject represents a user and is suitable for scripting. -
The
getEmail()method retrieves the user's email address if available, but may return a blank string due to security policies or execution context. -
The
getUserLoginId()method is deprecated and has been replaced bygetEmail().
Representation of a user, suitable for scripting.
Methods
| Method | Return type | Brief description |
|---|---|---|
String
|
Gets the user's email address, if available. |
Detailed documentation
get
Gets the user's email address, if available. If security policies do not allow access to the
user's email address, this method returns a blank string. The circumstances in which the email
address is available vary: for example, the user's email address is not available in any
context that allows a script to run without that user's authorization, like a simple on
or on
trigger, a custom function in Google Sheets, or a web app
deployed to "execute as me" (that is, authorized by the developer instead of the user).
However, these restrictions generally do not apply if the developer runs the script themselves
or belongs to the same Google Workspace domain as the user.
// Log the email address of the person running the script. Logger . log ( Session . getActiveUser (). getEmail ());
Return
String
— The user's email's address, or a blank string if security policies do not allow access
to the user's email address.
