Class User
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Usuario
Representación de un usuario, adecuada para secuencias de comandos.
Métodos
| Método | Tipo de datos que se muestra | Descripción breve |
getEmail() | String | Obtiene la dirección de correo electrónico del usuario, si está disponible. |
Métodos obsoletos
| Método | Tipo de datos que se muestra | Descripción breve |
getUserLoginId() | String | Obtiene la dirección de correo electrónico del usuario. |
Documentación detallada
getEmail()
Obtiene la dirección de correo electrónico del usuario, si está disponible. Si las políticas de seguridad no permiten el acceso a la dirección de correo electrónico del usuario, este método muestra una cadena vacía. Las circunstancias en las que la dirección de correo electrónico está disponible varían: por ejemplo, la dirección de correo electrónico del usuario no está disponible en ningún contexto que permita que se ejecute una secuencia de comandos sin la autorización de ese usuario, como un activador onOpen(e) o onEdit(e) simple, una función personalizada en Hojas de cálculo de Google o una app web implementada para "ejecutarse como yo" (es decir, autorizada por el desarrollador en lugar del usuario).
Sin embargo, estas restricciones generalmente no se aplican si el desarrollador ejecuta la secuencia de comandos por su cuenta o pertenece al mismo dominio de Google Workspace que el usuario.
// Log the email address of the person running the script.
Logger.log(Session.getActiveUser().getEmail());
Volver
String: Es la dirección de correo electrónico del usuario o una cadena vacía si las políticas de seguridad no permiten el acceso a la dirección de correo electrónico del usuario.
Métodos obsoletos
getUserLoginId()
Obsoleto. A partir del 24 de junio de 2013, se reemplazó por getEmail().
Obtiene la dirección de correo electrónico del usuario.
// Log the email address of the person running the script.
Logger.log(Session.getActiveUser().getUserLoginId());
Volver
String: Es la dirección de correo electrónico del usuario.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-26 (UTC)
[null,null,["Última actualización: 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."]]
