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-09-12 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-09-12 (حسب التوقيت العالمي المتفَّق عليه)"],[[["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."]]],[]]