Class User | Apps Script | Google for Developers (original) (raw)
Class User
Stay organized with collections Save and categorize content based on your preferences.
User
Representation of a user, suitable for scripting.
Methods
| Method | Return type | Brief description |
|---|---|---|
| getEmail() | String | Gets the user's email address, if available. |
Deprecated methods
| Method | Return type | Brief description |
|---|---|---|
| String | Gets the user's email address. |
Detailed documentation
getEmail()
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 onOpen(e) or onEdit(e) 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.
Deprecated methods
getUserLoginId()
getUserLoginId()Deprecated. As of June 24, 2013, replaced by [getEmail()](#getEmail%28%29).
Gets the user's email address.
// Log the email address of the person running the script. Logger.log(Session.getActiveUser().getUserLoginId());
Return
String — The user's email's address.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-12-02 UTC.