Class Session

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

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

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

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

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