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 لصورة المستخدم.

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

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 إذا لم تكن الصورة متاحة

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