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
| Metoda | Zwracany typ | Krótki opis |
|---|---|---|
getActiveUser() | User | Pobiera informacje o bieżącym użytkowniku. |
getActiveUserLocale() | String | Pobiera język bieżącego użytkownika w postaci ciągu znaków, na przykład en w przypadku języka angielskiego. |
getEffectiveUser() | User | Pobiera informacje o użytkowniku, pod którym działa skrypt. |
getScriptTimeZone() | String | Pobiera strefę czasową skryptu. |
getTemporaryActiveUserKey() | String | Pobiera 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.