Class Session

Sitzung

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

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
getActiveUser()	User	Ruft Informationen zum aktuellen Nutzer ab.
getActiveUserLocale()	String	Die Spracheinstellung des aktuellen Nutzers als String, z. B. en für Englisch.
getEffectiveUser()	User	Ruft Informationen zum Nutzer ab, in dessen Autorisierungsbereich das Script ausgeführt wird.
getScriptTimeZone()	String	Ruft die Zeitzone des Scripts ab.
getTemporaryActiveUserKey()	String	Es wird ein temporärer Schlüssel abgerufen, der für den aktiven Nutzer eindeutig ist, aber die Identität des Nutzers nicht preisgibt.

Eingestellte Methoden

Methode	Rückgabetyp	Kurzbeschreibung
getTimeZone()	String	Ruft die Zeitzone des Scripts ab.
getUser()	User	Ruft Informationen zum aktuellen Nutzer ab.

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 Verfügbarkeit der E-Mail-Adresse des Nutzers variiert: Beispielsweise ist die E-Mail-Adresse des Nutzers 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.
const email = Session.getActiveUser().getEmail();
Logger.log(email);

Rückflug

User – der aktuelle Nutzer

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

---

getActiveUserLocale()

Die Spracheinstellung des aktuellen Nutzers als String, 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 zum Nutzer ab, in dessen Autorisierungsbereich das Script ausgeführt wird. Wenn das Script eine Webanwendung ist, die auf „Als mich ausführen“ (der Entwickler) festgelegt ist, wird das Nutzerkonto des Entwicklers zurückgegeben. Wenn das Script unter einem installierbaren Trigger ausgeführt wird, wird das Konto des Nutzers zurückgegeben, der den Trigger erstellt hat. In den meisten anderen Fällen wird dasselbe Konto wie getActiveUser() zurückgegeben.

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

Rückflug

User: der Nutzer, in dessen Autorisierungsbereich das Script ausgeführt wird

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

---

getScriptTimeZone()

Ruft die Zeitzone des Scripts ab. Neue Scripts haben standardmäßig die Zeitzone des Eigentümers. Sie können die Zeitzone des Scripts jedoch ändern, indem Sie im Script-Editor auf Datei > Projekteigenschaften klicken. Tabellen haben eine separate Zeitzone, die Sie in Google Tabellen unter Datei > Tabelleneinstellungen ändern können. Zeitzonen in Tabellen, die sich von der Zeitzone des Scripts unterscheiden, sind eine häufige Ursache für Scriptfehler.

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

Rückflug

String – die Zeitzone des Scripts

---

getTemporaryActiveUserKey()

Es wird ein temporärer Schlüssel abgerufen, der für den aktiven Nutzer eindeutig ist, aber die Identität des Nutzers nicht preisgibt. Der temporäre Schlüssel wird alle 30 Tage rotiert und ist für das Script eindeutig.

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

Rückflug

String – der temporäre Schlüssel des aktiven Nutzers

Eingestellte Methoden

getTimeZone()

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Ruft die Zeitzone des Scripts ab. Neue Scripts haben standardmäßig die Zeitzone des Eigentümers. Sie können die Zeitzone des Scripts jedoch ändern, indem Sie im Script-Editor auf Datei > Projekteigenschaften klicken. Tabellen haben eine separate Zeitzone, die Sie in Google Tabellen unter Datei > Tabelleneinstellungen ändern können. Zeitzonen in Tabellen, die sich von der Zeitzone des Scripts unterscheiden, sind eine häufige Ursache für Scriptfehler.

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

Rückflug

String – die Zeitzone des Scripts

---

getUser()

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Ruft Informationen zum aktuellen Nutzer ab.

Rückflug

User: der aktuell angemeldete Nutzer

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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