Class Session

Sitzung

Die Klasse "Sitzung" bietet Zugriff auf Sitzungsinformationen, wie die E-Mail-Adresse des Nutzers (in unter bestimmten 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 über den Nutzer ab, unter dessen Berechtigung das Skript ausgeführt wird.
getScriptTimeZone()StringRuft die Zeitzone des Skripts ab.
getTemporaryActiveUserKey()StringRuft einen temporären Schlüssel ab, der für den aktiven Nutzer eindeutig ist, aber die Nutzeridentität nicht offenlegt.

Detaillierte Dokumentation

getActiveUser()

Ruft Informationen zum aktuellen Nutzer ab. Wenn Sicherheitsrichtlinien den Zugriff auf die Identität, gibt User.getEmail() einen leeren String zurück. Die Umstände, unter denen der E-Mail-Adresse verfügbar sind, variieren: Die E-Mail-Adresse des Nutzers ist beispielsweise in keiner Kontext, in dem ein Skript ohne die Zustimmung des Nutzers ausgeführt werden kann, z. B. ein einfacher onOpen(e)- oder onEdit(e)-Trigger, eine benutzerdefinierte Funktion in Google Tabellen oder eine Web-App für „Ausführen als ich“ (d. h. vom Entwickler und nicht 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ören.

// Log the email address of the person running the script.
var email = Session.getActiveUser().getEmail();
Logger.log(email);

Rückflug

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());

Rückflug

String: Ein String, der die Spracheinstellung des Nutzers darstellt


getEffectiveUser()

Ruft Informationen über den Nutzer ab, unter dessen Berechtigung das Skript ausgeführt wird. Wenn das Skript ein Webanwendung auf „Als ich ausführen“ festgelegt (den Entwickler), wird das Nutzerkonto des Entwicklers zurückgegeben. Wenn wird das Skript unter einem installierbaren Trigger enthält, wird das Konto des Nutzers zurückgegeben, der den Trigger erstellt hat. In den meisten anderen wird dasselbe Konto wie bei getActiveUser() zurückgegeben.

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

Rückflug

User: der Nutzer, unter dessen Berechtigung 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()

Ruft die Zeitzone des Skripts ab. Für neue Skripts wird standardmäßig die Zeitzone des Eigentümers verwendet, aber das Sie können die Zeitzone des Skripts ändern, indem Sie auf Datei > Projekteigenschaften im Skript Editor. Beachten Sie, dass Tabellen eine separate Zeitzone haben, die durch Klicken auf Datei > Tabelleneinstellungen in Google Tabellen. Tabellenzeitzonen, die sich von der Zeitzone des Skripts ist eine häufige Ursache von Skriptfehlern.

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

Rückflug

String: Zeitzone des Skripts


getTemporaryActiveUserKey()

Ruft einen temporären Schlüssel ab, der für den aktiven Nutzer eindeutig ist, aber die Nutzeridentität nicht offenlegt. 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());

Rückflug

String: der temporäre aktive Nutzerschlüssel

Verworfene Methoden