Class Session

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Sesja

Klasa sesji zapewnia dostęp do informacji o sesji, takich jak adres e-mail użytkownika (w niektórych przypadkach) i ustawienia języka.

Metody

MetodaZwracany typKrótki opis
getActiveUser()UserPobiera informacje o bieżącym użytkowniku.
getActiveUserLocale()StringPobiera ustawienie języka bieżącego użytkownika w postaci ciągu znaków, np. en w przypadku języka angielskiego.
getEffectiveUser()UserPobiera informacje o użytkowniku, któremu podlega skrypt.
getScriptTimeZone()StringPobiera strefę czasową skryptu.
getTemporaryActiveUserKey()StringPobiera klucz tymczasowy, który jest unikalny dla aktywnego użytkownika, ale nie ujawnia tożsamości użytkownika.

Szczegółowa dokumentacja

getActiveUser()

Pobiera informacje o bieżącym użytkowniku. Jeśli zasady zabezpieczeń nie zezwalają na dostęp do tożsamości użytkownika, User.getEmail() zwraca pusty ciąg znaków. Sytuacja, w której adres e-mail jest dostępny, może być różny: np. adres e-mail użytkownika jest niedostępny w kontekście umożliwiającym uruchomienie skryptu bez autoryzacji użytkownika, np. prostej aktywatora onOpen(e) lub onEdit(e), funkcji niestandardowej w Arkuszach Google albo aplikacji internetowej wdrożonej w trybie „mój” (czyli autoryzowana przez dewelopera zamiast użytkownika). Te ograniczenia zwykle nie obowiązują, jeśli deweloper sam 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);

Zwróć

User – bieżący użytkownik

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

getActiveUserLocale()

Pobiera ustawienie języka bieżącego użytkownika w postaci ciągu znaków, np. en w przypadku języka angielskiego.

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

Zwróć

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


getEffectiveUser()

Pobiera informacje o użytkowniku, któremu podlega skrypt. Jeśli skrypt jest aplikacją internetową, która jest ustawiona jako „deweloper” (zwracana przez dewelopera), zwracane jest konto użytkownika dewelopera. Jeśli skrypt działa w regule, którą można zainstalować, zostanie zwrócone konto użytkownika, który go utworzył. W większości przypadków jest to 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);

Zwróć

User – użytkownik, pod którego skryptem działa skrypt;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

getScriptTimeZone()

Pobiera strefę czasową skryptu. Nowe strefy są domyślnie ustawiane w strefie czasowej właściciela, ale strefę czasową skryptu można zmienić, klikając Plik i właściwości projektu w edytorze skryptów. Pamiętaj, że arkusze kalkulacyjne mają oddzielną strefę czasową, którą możesz zmienić, klikając Ustawienia pliku &arkusza kalkulacyjnego w Arkuszach Google. Strefy czasowe w arkuszu kalkulacyjnym różnią się od strefy czasowej skryptu, a często występują błędy w skryptach.

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

Zwróć

String – strefa czasowa skryptu


getTemporaryActiveUserKey()

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

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

Zwróć

String – tymczasowy aktywny klucz użytkownika

Wycofane metody