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

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