הפונקציה מקבלת את כתובת האימייל של המשתמש, אם היא זמינה. אם מדיניות האבטחה לא מאפשרת גישה לכתובת האימייל של המשתמש, השיטה הזו מחזירה מחרוזת ריקה. הנסיבות שבהן כתובת האימייל זמינה משתנות: לדוגמה, כתובת האימייל של המשתמש לא זמינה בכל הקשר שמאפשר להריץ סקריפט בלי הרשאה מהמשתמש הזה, כמו טריגר פשוט של onOpen(e) או onEdit(e), פונקציה מותאמת אישית ב-Google Sheets או אפליקציית אינטרנט שנפרסה ל'הפעלה בתור 'אני' (כלומר, הרשאה מהמפתח במקום מהמשתמש).
עם זאת, בדרך כלל המגבלות האלה לא חלות אם המפתח מפעיל את הסקריפט בעצמו או שייך לאותו דומיין Google Workspace כמו המשתמש.
// Log the email address of the person running the script.Logger.log(Session.getActiveUser().getEmail());
חזרה
String – כתובת האימייל של המשתמש, או מחרוזת ריקה אם מדיניות האבטחה לא מאפשרת גישה לכתובת האימייל של המשתמש.
שיטות שהוצאו משימוש
getUserLoginId()
הוצא משימוש. החל מ-24 ביוני 2013, הוחלף על ידי getEmail().
הפונקציה מקבלת את כתובת האימייל של המשתמש.
// Log the email address of the person running the script.Logger.log(Session.getActiveUser().getUserLoginId());
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2024-12-22 (שעון UTC)."],[[["Represents a user for scripting purposes, providing methods to access user information."],["`getEmail()` retrieves the user's email address if permitted by security policies, returning a blank string otherwise."],["`getUserLoginId()` is deprecated and replaced by `getEmail()` for retrieving the user's email address."],["Access to the user's email address might be restricted in certain contexts due to security considerations, such as unauthorized script execution."]]],[]]