Class User

Nutzer

Darstellung eines Nutzers, geeignet für die Verwendung in Skripts.

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
getEmail()	String	Ruft die E‑Mail-Adresse des Nutzers ab, sofern verfügbar.

Veraltete 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 Umstände, unter denen die E‑Mail-Adresse verfügbar ist, variieren. Die E‑Mail-Adresse des Nutzers ist beispielsweise in keinem Kontext verfügbar, in dem ein Skript ohne Autorisierung durch diesen Nutzer ausgeführt werden kann, z. B. bei einem einfachen onOpen(e)- oder onEdit(e)-Trigger, einer benutzerdefinierten Funktion in Google Sheets oder einer Webanwendung, die mit der Option „Als ich ausführen“ bereitgestellt wird (d. h. vom Entwickler anstelle des Nutzers autorisiert wird). Diese Einschränkungen gelten jedoch in der Regel nicht, wenn der Entwickler das Skript 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ückgabe

String – Die E‑Mail-Adresse des Nutzers oder ein leerer String, wenn Sicherheitsrichtlinien den Zugriff auf die E‑Mail-Adresse des Nutzers nicht zulassen.

Veraltete 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ückgabe

String – Die E‑Mail-Adresse des Nutzers.