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

الطرق التي تم إيقافها نهائيًا