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