Class Session

Recupera le informazioni sull'utente corrente. Se i criteri di sicurezza non consentono l'accesso all'identità dell'utente, User.getEmail() restituisce una stringa vuota. Le circostanze in cui l'indirizzo email è disponibile variano: ad esempio, l'indirizzo email dell'utente non è disponibile in nessun contesto che consenta l'esecuzione di uno script senza l'autorizzazione dell'utente, come un semplice attivatore onOpen(e) o onEdit(e), una funzione personalizzata in Fogli Google o un'app web di cui è stato eseguito il deployment per l'esecuzione come utente (ovvero autorizzata dallo sviluppatore anziché dall'utente). Tuttavia, in genere queste limitazioni non si applicano se lo sviluppatore esegue lo script autonomamente o appartiene allo stesso dominio Google Workspace dell'utente.

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

Invio

User: l'utente corrente

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

Restituisce l'impostazione della lingua dell'utente corrente come stringa, ad esempio en per l'inglese.

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

Invio

String: una stringa che rappresenta l'impostazione della lingua dell'utente

Recupera le informazioni sull'utente sotto la cui autorità viene eseguito lo script. Se lo script è un'app web impostata su "Esegui come me" (lo sviluppatore), viene restituito l'account utente dello sviluppatore. Se lo script viene eseguito in un attivatore installabile, viene restituito l'account dell'utente che ha creato l'attivatore. Nella maggior parte degli altri scenari, viene restituito lo stesso account di getActiveUser().

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

Invio

User: l'utente sotto la cui autorità viene eseguito lo script

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

Recupera il fuso orario dello script. Per impostazione predefinita, i nuovi script utilizzano il fuso orario del proprietario, ma il fuso orario dello script può essere modificato facendo clic su File > Proprietà del progetto nell'editor di script. Tieni presente che i fogli di lavoro hanno un fuso orario separato, che può essere modificato facendo clic su File > Impostazioni foglio di lavoro in Fogli Google. I fusi orari dei fogli di lavoro diversi da quello dello script sono una fonte frequente di bug di scripting.

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

Invio

String: il fuso orario dello script

Recupera una chiave temporanea univoca per l'utente attivo, ma non rivela la sua identità. La chiave temporanea viene ruotata ogni 30 giorni ed è univoca per lo script.

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

Invio

String: la chiave utente attiva temporanea