Class Session

Sitzung

Die Session-Klasse bietet Zugriff auf Sitzungsinformationen wie die E-Mail-Adresse des Nutzers (unter Umständen) und die Spracheinstellung.

Methoden

MethodeRückgabetypKurzbeschreibung
getActiveUser()UserRuft Informationen zum aktuellen Nutzer ab.
getActiveUserLocale()StringRuft die Spracheinstellung des aktuellen Nutzers als String ab, z. B. en für Englisch.
getEffectiveUser()UserRuft Informationen zu dem Nutzer ab, unter dessen Aufsicht das Skript ausgeführt wird.
getScriptTimeZone()StringZeitzone des Skripts abrufen.
getTemporaryActiveUserKey()StringRuft einen temporären Schlüssel ab, der für den aktiven Nutzer eindeutig ist, aber die Nutzeridentität nicht offengelegt.

Detaillierte Dokumentation

getActiveUser()

Ruft Informationen zum aktuellen Nutzer ab. Wenn Sicherheitsrichtlinien den Zugriff auf die Identität des Nutzers nicht zulassen, gibt User.getEmail() einen leeren String zurück. Die Umstände, in denen die E-Mail-Adresse verfügbar ist, sind unterschiedlich: Beispielsweise ist die E-Mail-Adresse des Nutzers nicht in einem Kontext verfügbar, der die Ausführung eines Skripts ohne die Autorisierung des Nutzers zulässt, z. B. ein einfacher onOpen(e)- oder onEdit(e)-Trigger, eine benutzerdefinierte Funktion in Google Tabellen oder eine Webanwendung, die zum Ausführen als ich bereitgestellt wird (also vom Entwickler statt vom Nutzer autorisiert). 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.
var email = Session.getActiveUser().getEmail();
Logger.log(email);

Return

User – der aktuelle Nutzer

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/userinfo.email

getActiveUserLocale()

Ruft die Spracheinstellung des aktuellen Nutzers als String ab, z. B. en für Englisch.

// Log the language setting of the person running the script.
Logger.log(Session.getActiveUserLocale());

Return

String: Ein String für die Spracheinstellung des Nutzers


getEffectiveUser()

Ruft Informationen zu dem Nutzer ab, unter dessen Aufsicht das Skript ausgeführt wird. Wenn das Skript eine Webanwendung ist, die auf „Als ich ausführen“ (Entwickler) festgelegt ist, wird das Nutzerkonto des Entwicklers zurückgegeben. Wenn das Skript unter einem installierbaren Trigger ausgeführt wird, wird das Konto des Nutzers zurückgegeben, der den Trigger erstellt hat. In den meisten anderen Szenarien wird dasselbe Konto zurückgegeben wie getActiveUser().

// Log the email address of the user under whose authority the script is running.
var email = Session.getEffectiveUser().getEmail();
Logger.log(email);

Return

User: der Nutzer, unter dessen Autorität das Skript ausgeführt wird

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/userinfo.email

getScriptTimeZone()

Zeitzone des Skripts abrufen. Für neue Skripts wird standardmäßig die Zeitzone des Inhabers verwendet. Sie können die Zeitzone des Skripts jedoch ändern. Klicken Sie dazu im Skripteditor auf Datei > Projekteigenschaften. Tabellen haben eine eigene Zeitzone, die Sie in Google Tabellen über Datei > Tabelleneinstellungen ändern können. Eine häufige Ursache von Skriptfehlern sind Tabellenzeitzonen, die von der Zeitzone des Skripts abweichen.

// Log the time zone of the script.
var timeZone = Session.getScriptTimeZone();
Logger.log(timeZone);

Return

String: die Zeitzone des Skripts


getTemporaryActiveUserKey()

Ruft einen temporären Schlüssel ab, der für den aktiven Nutzer eindeutig ist, aber die Nutzeridentität nicht offengelegt. Der temporäre Schlüssel wird alle 30 Tage rotiert und ist für das Skript eindeutig.

// Log the temporary key of the person running the script.
Logger.log(Session.getTemporaryActiveUserKey());

Return

String: der temporäre aktive Nutzerschlüssel

Verworfene Methoden