Class Session

Sessione

Il corso Sessione consente di accedere alle informazioni sulla sessione, come l'indirizzo email dell'utente (in alcune circostanze) e le impostazioni della lingua.

Metodi

Metodo	Tipo restituito	Breve descrizione
getActiveUser()	User	Recupera le informazioni sull'utente corrente.
getActiveUserLocale()	String	Restituisce l'impostazione della lingua dell'utente corrente come stringa, ad esempio en per l'inglese.
getEffectiveUser()	User	Recupera le 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 che non rivela l'identità dell'utente.

Metodi deprecati

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

Documentazione dettagliata

getActiveUser()

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 "come me" (ovvero, autorizzata dallo sviluppatore anziché dall'utente). Tuttavia, queste limitazioni generalmente non si applicano se lo sviluppatore esegue lo script o se appartiene allo stesso dominio Google Workspace dell'utente.

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

Ritorni

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

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

Ritorni

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

---

getEffectiveUser()

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 con un attivatore 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.
var email = Session.getEffectiveUser().getEmail();
Logger.log(email);

Ritorni

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 il fuso orario può essere modificato facendo clic su File > Proprietà 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 che differiscono da quello dello script sono una fonte frequente di bug di script.

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

Ritorni

String: il fuso orario dello script

---

getTemporaryActiveUserKey()

Recupera una chiave temporanea univoca per l'utente attivo, ma che 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());

Ritorni

String: la chiave utente attiva temporanea

Metodi deprecati

getTimeZone()

Obsoleta. Questa funzione è deprecata 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 il fuso orario può essere modificato facendo clic su File > Proprietà 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 che differiscono da quello dello script sono una fonte frequente di bug di script.

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

Ritorni

String: il fuso orario dello script

---

getUser()

Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Recupera le informazioni sull'utente corrente.

Ritorni

User: l'utente che ha 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