Class User

المستخدم

تمثل هذه السمة المستخدم مناسبًا للنصوص البرمجية.

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
getEmail()Stringتحصل على عنوان البريد الإلكتروني للمستخدم، إذا كان متاحًا.

الوثائق التفصيلية

getEmail()

تحصل على عنوان البريد الإلكتروني للمستخدم، إذا كان متاحًا. إذا كانت سياسات الأمان لا تسمح بالوصول إلى عنوان البريد الإلكتروني للمستخدم، فإن هذه الطريقة تعرض سلسلة فارغة. تختلف الحالات التي يتوفّر فيها عنوان البريد الإلكتروني: على سبيل المثال، لا يكون عنوان البريد الإلكتروني للمستخدم متاحًا في أي سياق يسمح بتشغيل النص البرمجي بدون إذن المستخدم، مثل المشغِّل onOpen(e) أو onEdit(e) البسيط، أو وظيفة مخصّصة في "جداول بيانات Google"، أو تطبيق ويب تم نشره من أجل "التنفيذ مثلي" (ويعني ذلك أنّ المطوّر يصرّح بذلك بدلاً من المستخدم). ومع ذلك، لا تنطبق هذه القيود بشكل عام إذا كان المطوّر يشغّل النص البرمجي بنفسه أو إذا كان ينتمي إلى نطاق Google Workspace نفسه الذي ينتمي إليه المستخدم.

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

استرجاع الكرة

String — عنوان البريد الإلكتروني للمستخدم أو سلسلة فارغة إذا كانت سياسات الأمان لا تسمح بالوصول إلى عنوان البريد الإلكتروني للمستخدم.

الطرق المتوقّفة نهائيًا