Class User

المستخدم

مستخدم مرتبط بملف في Google Drive يمكن الوصول إلى المستخدمين من خلال File.getEditors() وFolder.getViewers() وطرق أخرى.

// Log the email address of all users who have edit access to a file.
const file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
const editors = file.getEditors();
for (let i = 0; i < editors.length; i++) {
  Logger.log(editors[i].getEmail());
}

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
getDomain()	String	تحصل على اسم النطاق المرتبط بحساب المستخدم.
getEmail()	String	تحصل على عنوان البريد الإلكتروني للمستخدم.
getName()	String	الحصول على اسم المستخدم
getPhotoUrl()	String	تحصل على عنوان URL لصورة المستخدم.

الطرق المتوقّفة

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
getUserLoginId()	String	تحصل على عنوان البريد الإلكتروني للمستخدم.

مستندات تفصيلية

getDomain()

تحصل على اسم النطاق المرتبط بحساب المستخدم.

// Log the domain names associated with all users who have edit access to a
// file.
const file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
const editors = file.getEditors();
for (let i = 0; i < editors.length; i++) {
  Logger.log(editors[i].getDomain());
}

الإرجاع

String: اسم النطاق المرتبط بحساب المستخدم

---

getEmail()

تحصل على عنوان البريد الإلكتروني للمستخدم. لا يتوفّر عنوان البريد الإلكتروني للمستخدم إلا إذا اختَر مشاركة العنوان من صفحة إعدادات حساب Google+، أو إذا كان المستخدم ينتمي إلى النطاق نفسه الذي ينتمي إليه المستخدم الذي يشغّل النص البرمجي، وسمح مشرف النطاق لجميع المستخدمين في النطاق بالاطّلاع على عناوين البريد الإلكتروني للمستخدمين الآخرين.

// Log the email address of all users who have edit access to a file.
const file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
const editors = file.getEditors();
for (let i = 0; i < editors.length; i++) {
  Logger.log(editors[i].getEmail());
}

الإرجاع

String: عنوان البريد الإلكتروني للمستخدم، أو سلسلة فارغة إذا لم يكن عنوان البريد الإلكتروني متاحًا

---

getName()

الحصول على اسم المستخدم تعرض هذه الطريقة القيمة null إذا لم يكن اسم المستخدم متاحًا.

// Log the names of all users who have edit access to a file.
const file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
const editors = file.getEditors();
for (let i = 0; i < editors.length; i++) {
  Logger.log(editors[i].getName());
}

الإرجاع

String: اسم المستخدم، أو null إذا لم يكن الاسم متاحًا

---

getPhotoUrl()

تحصل على عنوان URL لصورة المستخدم. تعرض هذه الطريقة القيمة null إذا لم تكن صورة المستخدم متوفرة.

// Log the URLs for the photos of all users who have edit access to a file.
const file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
const editors = file.getEditors();
for (let i = 0; i < editors.length; i++) {
  Logger.log(editors[i].getPhotoUrl());
}

الإرجاع

String: عنوان URL لصورة المستخدم، أو null إذا لم تكن الصورة متاحة

الطرق المتوقّفة

getUserLoginId()

تمّ إيقاف هذا العمود نهائيًا. اعتبارًا من 24 حزيران (يونيو) 2013، تم استبداله بـ getEmail().

تحصل على عنوان البريد الإلكتروني للمستخدم.

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

الإرجاع

String - عنوان البريد الإلكتروني للمستخدم.