Class User
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Nutzer
Darstellung eines Nutzers, geeignet für Scripting.
Methoden
| Methode | Rückgabetyp | Kurzbeschreibung |
getEmail() | String | Ruft die E-Mail-Adresse des Nutzers ab, sofern verfügbar. |
Eingestellte Methoden
| Methode | Rückgabetyp | Kurzbeschreibung |
getUserLoginId() | String | Ruft die E-Mail-Adresse des Nutzers ab. |
Detaillierte Dokumentation
getEmail()
Ruft die E-Mail-Adresse des Nutzers ab, sofern verfügbar. Wenn Sicherheitsrichtlinien den Zugriff auf die E-Mail-Adresse des Nutzers nicht zulassen, gibt diese Methode einen leeren String zurück. Die Verfügbarkeit der E-Mail-Adresse des Nutzers variiert: So ist sie beispielsweise in keinem Kontext verfügbar, in dem ein Script ohne Autorisierung dieses Nutzers ausgeführt werden kann, z. B. bei einem einfachen onOpen(e)- oder onEdit(e)-Trigger, einer benutzerdefinierten Funktion in Google Tabellen oder einer Webanwendung, die mit der Option „Als mich ausführen“ bereitgestellt wurde (d. h. vom Entwickler statt vom Nutzer autorisiert).
Diese Einschränkungen gelten jedoch in der Regel nicht, wenn der Entwickler das Script selbst ausführt oder zur selben Google Workspace-Domain wie der Nutzer gehört.
// Log the email address of the person running the script.
Logger.log(Session.getActiveUser().getEmail());
Rückflug
String: Die E-Mail-Adresse des Nutzers oder ein leerer String, wenn Sicherheitsrichtlinien den Zugriff auf die E-Mail-Adresse des Nutzers nicht zulassen.
Eingestellte Methoden
getUserLoginId()
Veraltet. Seit dem 24. Juni 2013 durch getEmail() ersetzt.
Ruft die E-Mail-Adresse des Nutzers ab.
// Log the email address of the person running the script.
Logger.log(Session.getActiveUser().getUserLoginId());
Rückflug
String: Die E-Mail-Adresse des Nutzers.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-26 (UTC).
[null,null,["Zuletzt aktualisiert: 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."]]
