Class User
المستخدم
تمثيل مستخدم، مناسب للبرمجة
الطُرق
الطريقة | نوع القيمة التي يتم عرضها | وصف قصير |
getEmail() | String | تحصل على عنوان البريد الإلكتروني للمستخدم، إن توفّر. |
الطرق المتوقّفة
الطريقة | نوع القيمة التي يتم عرضها | وصف قصير |
getUserLoginId()
| 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
: عنوان البريد الإلكتروني للمستخدم، أو سلسلة فارغة إذا كانت سياسات الأمان لا تسمح بالوصول
إلى عنوان البريد الإلكتروني للمستخدم
الطرق المتوقّفة
getUserLoginId()
تمّ إيقاف هذا العمود نهائيًا. اعتبارًا من 24 حزيران (يونيو) 2013، تم استبداله بـ getEmail()
.
تحصل على عنوان البريد الإلكتروني للمستخدم.
// Log the email address of the person running the script.
Logger.log(Session.getActiveUser().getUserLoginId());
الإرجاع
String
- عنوان البريد الإلكتروني للمستخدم.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-12-22 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-12-22 (حسب التوقيت العالمي المتفَّق عليه)"],[[["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."]]],[]]