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 של התמונה של המשתמש.

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

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

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