Class User

Nutzer

Ein Nutzer, der mit einer Datei in Google Drive verknüpft ist. Auf Nutzer kann über File.getEditors(), Folder.getViewers() und andere Methoden zugegriffen werden.

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

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
getDomain()	String|null	Ruft den Domainnamen ab, der mit dem Konto des Nutzers verknüpft ist.
getEmail()	String|null	Ruft die E-Mail-Adresse des Nutzers ab.
getName()	String|null	Ruft den Namen des Nutzers ab.
getPhotoUrl()	String|null	Ruft die URL für das Foto des Nutzers ab.

Veraltete Methoden

Methode	Rückgabetyp	Kurzbeschreibung
getUserLoginId()	String	Ruft die E-Mail-Adresse des Nutzers ab.

Detaillierte Dokumentation

getDomain()

Ruft den Domainnamen ab, der mit dem Konto des Nutzers verknüpft ist.

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

Rückgabe

String|null – der Domainname, der mit dem Konto des Nutzers verknüpft ist

---

getEmail()

Ruft die E-Mail-Adresse des Nutzers ab. Die E-Mail-Adresse des Nutzers ist nur verfügbar, wenn der Nutzer die Adresse auf der Seite mit den Google+‑Kontoeinstellungen freigegeben hat oder wenn der Nutzer zur selben Domain wie der Nutzer gehört, der das Skript ausführt, und der Domainadministrator allen Nutzern in der Domain erlaubt hat, die E-Mail-Adressen anderer Nutzer zu sehen.

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

Rückgabe

String|null – die E-Mail-Adresse des Nutzers oder ein leerer String, wenn die E-Mail-Adresse nicht verfügbar ist

---

getName()

Ruft den Namen des Nutzers ab. Diese Methode gibt null zurück, wenn der Name des Nutzers nicht verfügbar ist.

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

Rückgabe

String|null – der Name des Nutzers oder null, wenn der Name nicht verfügbar ist

---

getPhotoUrl()

Ruft die URL für das Foto des Nutzers ab. Diese Methode gibt null zurück, wenn das Foto des Nutzers nicht verfügbar ist.

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

Rückgabe

String|null – die URL für das Foto des Nutzers oder null, wenn das Foto nicht verfügbar ist

Veraltete Methoden

getUserLoginId()

Veraltet. Seit dem 24. Juni 2013 durch getEmail() ersetzt.

Ruft die E-Mail-Adresse des Nutzers ab.

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

Rückgabe

String – die E-Mail-Adresse des Nutzers