Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.
Session
La classe Session permet d'accéder aux informations de session, telles que l'adresse e-mail de l'utilisateur (dans certains cas) et le paramètre de langue.
Récupère des informations sur l'utilisateur actuel.
Documentation détaillée
getActiveUser()
Récupère des informations sur l'utilisateur actuel. Si les règles de sécurité n'autorisent pas l'accès à l'identité de l'utilisateur, User.getEmail() renvoie une chaîne vide. Les circonstances dans lesquelles l'adresse e-mail est disponible varient: par exemple, l'adresse e-mail de l'utilisateur n'est disponible dans aucun contexte permettant l'exécution d'un script sans l'autorisation de cet utilisateur, comme un déclencheur onOpen(e) ou onEdit(e) simple, une fonction personnalisée dans Google Sheets ou une application Web déployée pour "s'exécuter en tant que moi" (c'est-à-dire autorisée par le développeur plutôt que par l'utilisateur). Toutefois, ces restrictions ne s'appliquent généralement pas si le développeur exécute le script lui-même ou appartient au même domaine Google Workspace que l'utilisateur.
// Log the email address of the person running the script.constemail=Session.getActiveUser().getEmail();Logger.log(email);
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
https://www.googleapis.com/auth/userinfo.email
getActiveUserLocale()
Récupère le paramètre linguistique de l'utilisateur actuel sous forme de chaîne (par exemple, en pour l'anglais).
// Log the language setting of the person running the script.Logger.log(Session.getActiveUserLocale());
Renvois
String : chaîne représentant les paramètres linguistiques de l'utilisateur
getEffectiveUser()
Récupère des informations sur l'utilisateur sous l'autorité duquel le script s'exécute. Si le script est une application Web définie sur "Exécuter en tant que moi" (le développeur), le compte utilisateur du développeur est renvoyé. Si le script s'exécute sous un déclencheur installable, le compte de l'utilisateur qui a créé le déclencheur est renvoyé. Dans la plupart des autres scénarios, le même compte est renvoyé que pour getActiveUser().
// Log the email address of the user under whose authority the script is// running.constemail=Session.getEffectiveUser().getEmail();Logger.log(email);
Renvois
User : utilisateur sous l'autorité duquel le script s'exécute
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
https://www.googleapis.com/auth/userinfo.email
getScriptTimeZone()
Récupère le fuseau horaire du script. Le fuseau horaire par défaut des nouveaux scripts est celui du propriétaire, mais vous pouvez le modifier en cliquant sur File > Project properties (Fichier > Propriétés du projet) dans l'éditeur de script. Notez que les feuilles de calcul ont un fuseau horaire distinct, que vous pouvez modifier en cliquant sur Fichier > Paramètres de la feuille de calcul dans Google Sheets. Les fuseaux horaires de la feuille de calcul qui diffèrent du fuseau horaire du script sont une source fréquente de bugs de script.
// Log the time zone of the script.consttimeZone=Session.getScriptTimeZone();Logger.log(timeZone);
Renvois
String : fuseau horaire du script
getTemporaryActiveUserKey()
Récupère une clé temporaire propre à l'utilisateur actif, mais qui ne révèle pas son identité. La clé temporaire est remplacée tous les 30 jours et est propre au script.
// Log the temporary key of the person running the script.Logger.log(Session.getTemporaryActiveUserKey());
Renvois
String : clé temporaire de l'utilisateur actif
Méthodes obsolètes
getTimeZone()
Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.
Récupère le fuseau horaire du script. Le fuseau horaire par défaut des nouveaux scripts est celui du propriétaire, mais vous pouvez le modifier en cliquant sur File > Project properties (Fichier > Propriétés du projet) dans l'éditeur de script. Notez que les feuilles de calcul ont un fuseau horaire distinct, que vous pouvez modifier en cliquant sur Fichier > Paramètres de la feuille de calcul dans Google Sheets. Les fuseaux horaires de la feuille de calcul qui diffèrent du fuseau horaire du script sont une source fréquente de bugs de script.
// Log the time zone of the script.consttimeZone=Session.getTimeZone();Logger.log(timeZone);
Renvois
String : fuseau horaire du script
getUser()
Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.
Récupère des informations sur l'utilisateur actuel.
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
https://www.googleapis.com/auth/userinfo.email
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/26 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/07/26 (UTC)."],[[["\u003cp\u003eThe \u003ccode\u003eSession\u003c/code\u003e 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.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve information about the active user, effective user, script time zone, and a temporary active user key using methods like \u003ccode\u003egetActiveUser()\u003c/code\u003e, \u003ccode\u003egetEffectiveUser()\u003c/code\u003e, \u003ccode\u003egetScriptTimeZone()\u003c/code\u003e, and \u003ccode\u003egetTemporaryActiveUserKey()\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eSome methods like \u003ccode\u003egetTimeZone()\u003c/code\u003e and \u003ccode\u003egetUser()\u003c/code\u003e are deprecated and should be replaced with their updated counterparts such as \u003ccode\u003egetScriptTimeZone()\u003c/code\u003e and \u003ccode\u003egetActiveUser()\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eWhile the user's email address can be accessed in certain circumstances using \u003ccode\u003egetActiveUser().getEmail()\u003c/code\u003e or \u003ccode\u003egetEffectiveUser().getEmail()\u003c/code\u003e, it may not be available if security policies restrict access or in contexts without explicit user authorization.\u003c/p\u003e\n"],["\u003cp\u003eAccessing user information may require specific authorization scopes, like \u003ccode\u003ehttps://www.googleapis.com/auth/userinfo.email\u003c/code\u003e, to be granted to the script.\u003c/p\u003e\n"]]],[],null,["Session\n\nThe Session class provides access to session information, such as the user's email address (in\nsome circumstances) and language setting. \n\nMethods\n\n| Method | Return type | Brief description |\n|-------------------------------------------------------------|------------------------------------------|-----------------------------------------------------------------------------------------------|\n| [getActiveUser()](#getActiveUser()) | [User](/apps-script/reference/base/user) | Gets information about the current user. |\n| [getActiveUserLocale()](#getActiveUserLocale()) | `String` | Gets the language setting of the current user as a string---for example, `en` for English. |\n| [getEffectiveUser()](#getEffectiveUser()) | [User](/apps-script/reference/base/user) | Gets information about the user under whose authority the script is running. |\n| [getScriptTimeZone()](#getScriptTimeZone()) | `String` | Gets the time zone of the script. |\n| [getTemporaryActiveUserKey()](#getTemporaryActiveUserKey()) | `String` | Gets a temporary key that is unique to the active user but does not reveal the user identity. |\n\nDeprecated methods\n\n| Method | Return type | Brief description |\n|---------------------------------|------------------------------------------|------------------------------------------|\n| [getTimeZone()](#getTimeZone()) | `String` | Gets the time zone of the script. |\n| [getUser()](#getUser()) | [User](/apps-script/reference/base/user) | Gets information about the current user. |\n\nDetailed documentation \n\n`get``Active``User()` \nGets information about the current user. If security policies do not allow access to the user's\nidentity, [User.getEmail()](/apps-script/reference/base/user#getEmail()) returns a blank string. The circumstances in which the\nemail address is available vary: for example, the user's email address is not available in any\ncontext that allows a script to run without that user's authorization, like a simple `on``Open(e)` or `on``Edit(e)` trigger, a custom function in Google Sheets, or a web app\ndeployed to \"execute as me\" (that is, authorized by the developer instead of the user).\nHowever, these restrictions generally do not apply if the developer runs the script themselves\nor belongs to the same Google Workspace domain as the user.\n\n```javascript\n// Log the email address of the person running the script.\nconst email = Session.getActiveUser().getEmail();\nLogger.log(email);\n```\n\nReturn\n\n\n[User](/apps-script/reference/base/user) --- the current user\n\nAuthorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/userinfo.email`\n\n*** ** * ** ***\n\n`get``Active``User``Locale()` \nGets the language setting of the current user as a string---for example, `en` for English.\n\n```javascript\n// Log the language setting of the person running the script.\nLogger.log(Session.getActiveUserLocale());\n```\n\nReturn\n\n\n`String` --- a string that represents the user's language setting\n\n*** ** * ** ***\n\n`get``Effective``User()` \nGets information about the user under whose authority the script is running. If the script is a\nweb app set to \"execute as me\" (the developer), this returns the developer's user account. If\nthe script is running under an [installable\ntrigger](/apps-script/understanding_triggers), this returns the account of the user who created the trigger. In most other\nscenarios, this returns the same account as [getActiveUser()](#getActiveUser()).\n\n```javascript\n// Log the email address of the user under whose authority the script is\n// running.\nconst email = Session.getEffectiveUser().getEmail();\nLogger.log(email);\n```\n\nReturn\n\n\n[User](/apps-script/reference/base/user) --- the user under whose authority the script is running\n\nAuthorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/userinfo.email`\n\n*** ** * ** ***\n\n`get``Script``Time``Zone()` \nGets the time zone of the script. New scripts default to the owner's time zone, but the\nscript's time zone can be changed by clicking **File \\\u003e Project properties** in the script\neditor. Note that spreadsheets have a separate time zone, which can be changed by clicking\n**File \\\u003e Spreadsheet settings** in Google Sheets. Spreadsheet time zones that differ from\nthe script time zone are a frequent source of scripting bugs.\n\n```javascript\n// Log the time zone of the script.\nconst timeZone = Session.getScriptTimeZone();\nLogger.log(timeZone);\n```\n\nReturn\n\n\n`String` --- the time zone of the script\n\n*** ** * ** ***\n\n`get``Temporary``Active``User``Key()` \nGets a temporary key that is unique to the active user but does not reveal the user identity.\nThe temporary key rotates every 30 days and is unique to the script.\n\n```javascript\n// Log the temporary key of the person running the script.\nLogger.log(Session.getTemporaryActiveUserKey());\n```\n\nReturn\n\n\n`String` --- the temporary active user key\n\nDeprecated methods \n\n`get``Time``Zone()` \n\n**Deprecated.** This function is deprecated and should not be used in new scripts.\n\nGets the time zone of the script. New scripts default to the owner's time zone, but the\nscript's time zone can be changed by clicking **File \\\u003e Project properties** in the script\neditor. Note that spreadsheets have a separate time zone, which can be changed by clicking\n**File \\\u003e Spreadsheet settings** in Google Sheets. Spreadsheet time zones that differ from\nthe script time zone are a frequent source of scripting bugs.\n\n```javascript\n// Log the time zone of the script.\nconst timeZone = Session.getTimeZone();\nLogger.log(timeZone);\n```\n\nReturn\n\n\n`String` --- the time zone of the script\n\n*** ** * ** ***\n\n`get``User()` \n\n**Deprecated.** This function is deprecated and should not be used in new scripts.\n\nGets information about the current user.\n\nReturn\n\n\n[User](/apps-script/reference/base/user) --- the currently signed in user\n\nAuthorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/userinfo.email`"]]
