Class Session

Sessione

La classe Session fornisce l'accesso alle informazioni sulla sessione, come l'indirizzo email dell'utente (in alcune circostanze) e l'impostazione della lingua.

Metodi

Metodo	Tipo restituito	Breve descrizione
getActiveUser()	User	Recupera informazioni sull'utente corrente.
getActiveUserLocale()	String	Recupera l'impostazione della lingua dell'utente corrente come stringa, ad esempio en per l'inglese.
getEffectiveUser()	User	Recupera informazioni sull'utente sotto la cui autorità viene eseguito lo script.
getScriptTimeZone()	String	Restituisce il fuso orario dello script.
getTemporaryActiveUserKey()	String	Recupera una chiave temporanea univoca per l'utente attivo, ma non rivela l'identità dell'utente.

Metodi ritirati

Metodo	Tipo restituito	Breve descrizione
getTimeZone()	String	Restituisce il fuso orario dello script.
getUser()	User	Recupera informazioni sull'utente corrente.

Documentazione dettagliata

getActiveUser()

Recupera 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 trigger onOpen(e) o onEdit(e), una funzione personalizzata in Fogli Google o un'app web di cui è stato eseguito il deployment con l'opzione "Esegui come me" (ovvero autorizzata dallo sviluppatore anziché dall'utente). Tuttavia, queste limitazioni in genere non si applicano se lo sviluppatore esegue lo script personalmente 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);

Indietro

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

---

getActiveUserLocale()

Recupera 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());

Indietro

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

---

getEffectiveUser()

Recupera 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 con un trigger installabile, viene restituito l'account dell'utente che ha creato il trigger. 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);

Indietro

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

---

getScriptTimeZone()

Restituisce il fuso orario dello script. Per impostazione predefinita, i nuovi script utilizzano il fuso orario del proprietario, ma 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 del foglio di lavoro diversi da quelli dello script sono una frequente fonte di bug di scripting.

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

Indietro

String: il fuso orario dello script

---

getTemporaryActiveUserKey()

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

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

Indietro

String: la chiave utente attivo temporanea

Metodi ritirati

getTimeZone()

Deprecato. Questa funzione è obsoleta e non deve essere utilizzata nei nuovi script.

Restituisce il fuso orario dello script. Per impostazione predefinita, i nuovi script utilizzano il fuso orario del proprietario, ma 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 del foglio di lavoro diversi da quelli dello script sono una frequente fonte di bug di scripting.

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

Indietro

String: il fuso orario dello script

---

getUser()

Deprecato. Questa funzione è obsoleta e non deve essere utilizzata nei nuovi script.

Recupera informazioni sull'utente corrente.

Indietro

User: l'utente che ha attualmente eseguito l'accesso

Autorizzazione

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

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