Class Session

Sesja

Klasa Session daje dostęp do informacji o sesji, takich jak adres e-mail użytkownika (w w pewnych okolicznościach) i ustawienia języka.

Metody

MetodaZwracany typKrótki opis
getActiveUser()UserPobiera informacje o bieżącym użytkowniku.
getActiveUserLocale()StringPobiera język bieżącego użytkownika w postaci ciągu znaków, na przykład en w przypadku języka angielskiego.
getEffectiveUser()UserPobiera informacje o użytkowniku, pod którym działa skrypt.
getScriptTimeZone()StringPobiera strefę czasową skryptu.
getTemporaryActiveUserKey()StringPobiera klucz tymczasowy, który jest unikalny dla aktywnego użytkownika, ale nie ujawnia jego tożsamości.

Szczegółowa dokumentacja

getActiveUser()

Pobiera informacje o bieżącym użytkowniku. Jeśli zasady zabezpieczeń nie zezwalają na dostęp do Identity, User.getEmail() zwraca pusty ciąg znaków. Okoliczności, w których dostępny jest inny adres e-mail, np. adres e-mail użytkownika nie jest kontekst umożliwiający uruchamianie skryptu bez zgody użytkownika, na przykład prosty wyzwalacz onOpen(e) lub onEdit(e), niestandardową funkcję w Arkuszach Google lub aplikację internetową. wdrożono w trybie „wykonywaj jako ja” (to znaczy za zgodą dewelopera, a nie użytkownika). Ograniczenia te zazwyczaj nie obowiązują, jeśli programista samodzielnie uruchamia skrypt. lub należy do tej samej domeny Google Workspace co użytkownik.

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

Powrót

User – obecny użytkownik,

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getActiveUserLocale()

Pobiera język bieżącego użytkownika w postaci ciągu znaków, na przykład en w przypadku języka angielskiego.

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

Powrót

String – ciąg znaków reprezentujący ustawienie języka użytkownika;


getEffectiveUser()

Pobiera informacje o użytkowniku, pod którym działa skrypt. Jeśli skrypt to aplikacja internetowa z ustawieniem „Wykonywanie jako ja” (deweloper), spowoduje to wyświetlenie konta użytkownika dewelopera. Jeśli skrypt działa w edytorze aktywator, zwraca konto użytkownika, który utworzył regułę. W większości innych w scenariuszach zwracanych jest to samo konto co getActiveUser().

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

Powrót

User – użytkownik, pod którego kontrolą działa skrypt.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getScriptTimeZone()

Pobiera strefę czasową skryptu. Nowe skrypty domyślnie używają strefy czasowej właściciela, ale aby zmienić strefę czasową skryptu, kliknij kolejno Plik > Właściwości projektu w skrypcie redaktorem. Arkusze kalkulacyjne mają oddzielną strefę czasową, którą można zmienić, klikając Plik > Ustawienia arkusza kalkulacyjnego w Arkuszach Google. Strefy czasowe arkusza kalkulacyjnego różnią się od strefa czasowa skryptu jest częstym źródłem błędów skryptów.

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

Powrót

String – strefa czasowa skryptu,


getTemporaryActiveUserKey()

Pobiera klucz tymczasowy, który jest unikalny dla aktywnego użytkownika, ale nie ujawnia jego tożsamości. Klucz tymczasowy zmienia się co 30 dni i jest unikalny dla skryptu.

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

Powrót

String – tymczasowy, aktywny klucz użytkownika.

Wycofane metody