Die Klasse "Sitzung" bietet Zugriff auf Sitzungsinformationen, wie die E-Mail-Adresse des Nutzers (in unter bestimmten Umständen) und die Spracheinstellung.
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
getActiveUser() | User | Ruft Informationen zum aktuellen Nutzer ab. |
getActiveUserLocale() | String | Ruft die Spracheinstellung des aktuellen Nutzers als String ab, z. B. en für Englisch. |
getEffectiveUser() | User | Ruft Informationen über den Nutzer ab, unter dessen Berechtigung das Skript ausgeführt wird. |
getScriptTimeZone() | String | Ruft die Zeitzone des Skripts ab. |
getTemporaryActiveUserKey() | String | Ruft 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