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|nullتعرض هذه الطريقة اسم النطاق المرتبط بحساب المستخدم.
getEmail()String|nullتعرض هذه السمة عنوان البريد الإلكتروني للمستخدم.
getName()String|nullتعرض هذه السمة اسم المستخدم.
getPhotoUrl()String|nullتعرض هذه الطريقة عنوان 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|null: اسم النطاق المرتبط بحساب المستخدم

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|null: عنوان البريد الإلكتروني للمستخدم أو سلسلة فارغة إذا لم يكن عنوان البريد الإلكتروني متاحًا

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: اسم المستخدم، أو 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|null: عنوان URL لصورة المستخدم، أو null إذا لم تكن الصورة متاحة

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