يحصل على عنوان البريد الإلكتروني للمستخدم، إذا كان متاحًا. إذا كانت سياسات الأمان لا تسمح بالوصول إلى
عنوان البريد الإلكتروني للمستخدم، فإن هذه الطريقة تُرجع سلسلة فارغة. الظروف التي قد تطرأ فيها رسالة البريد الإلكتروني
يختلف عنوان البريد الإلكتروني المتوفر: على سبيل المثال، لا يكون عنوان البريد الإلكتروني الخاص بالمستخدم متاحًا في
سياق يسمح بتشغيل نص برمجي بدون إذن المستخدم، مثل مشغِّل 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());
تاريخ التعديل الأخير: 2024-09-12 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 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."]]],[]]