يحصل على عنوان البريد الإلكتروني للمستخدم، إذا كان متوفرًا. إذا كانت سياسات الأمان لا تسمح بالوصول إلى عنوان البريد الإلكتروني للمستخدم، ستعرض هذه الطريقة سلسلة فارغة. تختلف الظروف التي يتوفّر فيها عنوان البريد الإلكتروني: على سبيل المثال، لا يتوفّر عنوان البريد الإلكتروني للمستخدم في أي سياق يسمح بتشغيل نص برمجي بدون إذن من هذا المستخدم، مثل مشغِّل onOpen(e) أو onEdit(e) بسيط، أو وظيفة مُخصَّصة في"جداول بيانات Google"، أو تطبيق ويب تم تطبيقه على"والتنفيذ نيابةً عني" (وهو إذن مفوَّض من المستخدم بدلاً من المستخدم).
ومع ذلك، لا تنطبق هذه القيود بشكل عام إذا كان مطوّر البرامج يشغّل النص البرمجي بنفسه أو ينتمي إلى نطاق 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());
