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());
}

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
getDomain()	String	הפונקציה מקבלת את שם הדומיין שמשויך לחשבון המשתמש.
getEmail()	String	הפונקציה מקבלת את כתובת האימייל של המשתמש.
getName()	String	הפונקציה מקבלת את שם המשתמש.
getPhotoUrl()	String	הפונקציה מקבלת את כתובת ה-URL של התמונה של המשתמש.

שיטות שהוצאו משימוש

שיטה	סוג הערך המוחזר	תיאור קצר
getUserLoginId()	String	הפונקציה מקבלת את כתובת האימייל של המשתמש.

מסמכים מפורטים

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 אם התמונה לא זמינה

שיטות שהוצאו משימוש

getUserLoginId()

הוצא משימוש. החל מ-24 ביוני 2013, הוחלף על ידי getEmail().

הפונקציה מקבלת את כתובת האימייל של המשתמש.

// Log the email address of the person running the script.
Logger.log(Session.getActiveUser().getUserLoginId());

חזרה

String – כתובת האימייל של המשתמש.