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 - כתובת האתר של תמונת המשתמש, או null אם התמונה אינה זמינה

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