Class User

المستخدم

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

// Log the email address of all users who have edit access to a file.
var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
var editors = file.getEditors();
for (var 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.
var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
var editors = file.getEditors();
for (var 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.
var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
var editors = file.getEditors();
for (var 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.
var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
var editors = file.getEditors();
for (var 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.
var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
var editors = file.getEditors();
for (var i = 0; i < editors.length; i++) {
  Logger.log(editors[i].getPhotoUrl());
}

استرجاع الكرة

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

الطرق المتوقّفة نهائيًا