A RetroSearch Logo

Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Search Query:

Showing content from https://developers.google.com/apps-script/reference/base/session below:

Class Session | Apps Script

Class Session

Stay organized with collections Save and categorize content based on your preferences.

Session

The Session class provides access to session information, such as the user's email address (in some circumstances) and language setting.

Methods Deprecated methods Method Return type Brief description getTimeZone() String Gets the time zone of the script. getUser() User Gets information about the current user. Detailed documentation getActiveUser()

Gets information about the current user. If security policies do not allow access to the user's identity, User.getEmail() returns a blank string. The circumstances in which the email address is available vary: for example, the user's email address is not available in any context that allows a script to run without that user's authorization, like a simple onOpen(e) or onEdit(e) trigger, a custom function in Google Sheets, or a web app deployed to "execute as me" (that is, authorized by the developer instead of the user). However, these restrictions generally do not apply if the developer runs the script themselves or belongs to the same Google Workspace domain as the user.

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

User — the current user

Scripts that use this method require authorization with one or more of the following scopes:

getActiveUserLocale()

Gets the language setting of the current user as a string—for example, en for English.

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

String — a string that represents the user's language setting

getEffectiveUser()

Gets information about the user under whose authority the script is running. If the script is a web app set to "execute as me" (the developer), this returns the developer's user account. If the script is running under an installable trigger, this returns the account of the user who created the trigger. In most other scenarios, this returns the same account as getActiveUser().

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

User — the user under whose authority the script is running

Authorization

Scripts that use this method require authorization with one or more of the following scopes:

getScriptTimeZone()

Gets the time zone of the script. New scripts default to the owner's time zone, but the script's time zone can be changed by clicking File > Project properties in the script editor. Note that spreadsheets have a separate time zone, which can be changed by clicking File > Spreadsheet settings in Google Sheets. Spreadsheet time zones that differ from the script time zone are a frequent source of scripting bugs.

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

String — the time zone of the script

getTemporaryActiveUserKey()

Gets a temporary key that is unique to the active user but does not reveal the user identity. The temporary key rotates every 30 days and is unique to the script.

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

String — the temporary active user key

Deprecated methods getTimeZone()

Deprecated. This function is deprecated and should not be used in new scripts.

Gets the time zone of the script. New scripts default to the owner's time zone, but the script's time zone can be changed by clicking File > Project properties in the script editor. Note that spreadsheets have a separate time zone, which can be changed by clicking File > Spreadsheet settings in Google Sheets. Spreadsheet time zones that differ from the script time zone are a frequent source of scripting bugs.

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

String — the time zone of the script

getUser()

Deprecated. This function is deprecated and should not be used in new scripts.

Gets information about the current user.

Return

User — the currently signed in user

Authorization

Scripts that use this method require authorization with one or more of the following scopes:

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2024-12-02 UTC.

[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-12-02 UTC."],[[["The `Session` class in Apps Script allows you to access information about the current user and the script's environment, such as the user's locale and the script's time zone."],["You can retrieve information about the active user, effective user, script time zone, and a temporary active user key using methods like `getActiveUser()`, `getEffectiveUser()`, `getScriptTimeZone()`, and `getTemporaryActiveUserKey()`."],["Some methods like `getTimeZone()` and `getUser()` are deprecated and should be replaced with their updated counterparts such as `getScriptTimeZone()` and `getActiveUser()`."],["While the user's email address can be accessed in certain circumstances using `getActiveUser().getEmail()` or `getEffectiveUser().getEmail()`, it may not be available if security policies restrict access or in contexts without explicit user authorization."],["Accessing user information may require specific authorization scopes, like `https://www.googleapis.com/auth/userinfo.email`, to be granted to the script."]]],[]]


RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4