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