Class Folder

Ordner

Einen Ordner in Google Drive. Über DriveApp können Sie auf Ordner zugreifen oder sie erstellen.

// Log the name of every folder in the user's Drive.
const folders = DriveApp.getFolders();
while (folders.hasNext()) {
  const folder = folders.next();
  Logger.log(folder.getName());
}

Methoden

MethodeRückgabetypKurzbeschreibung
addEditor(emailAddress)FolderDer angegebene Nutzer wird der Liste der Mitbearbeiter für die Folder hinzugefügt.
addEditor(user)FolderDer angegebene Nutzer wird der Liste der Mitbearbeiter für die Folder hinzugefügt.
addEditors(emailAddresses)FolderFügt der Liste der Mitbearbeiter für die Folder das angegebene Nutzerarray hinzu.
addViewer(emailAddress)FolderDer angegebene Nutzer wird der Liste der Zuschauer für die Folder hinzugefügt.
addViewer(user)FolderDer angegebene Nutzer wird der Liste der Zuschauer für die Folder hinzugefügt.
addViewers(emailAddresses)FolderFügen Sie der Liste der Zuschauer für die Folder das angegebene Array von Nutzern hinzu.
createFile(blob)FileErstellt eine Datei im aktuellen Ordner aus einer angegebenen Blob mit beliebigen Daten.
createFile(name, content)FileErstellt eine Textdatei im aktuellen Ordner mit dem angegebenen Namen und Inhalt.
createFile(name, content, mimeType)FileErstellt eine Datei im aktuellen Ordner mit dem angegebenen Namen, Inhalt und MIME-Typ.
createFolder(name)FolderErstellt im aktuellen Ordner einen Ordner mit dem angegebenen Namen.
createShortcut(targetId)FileErstellt eine Verknüpfung zur angegebenen Drive-Element-ID und gibt sie zurück.
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)FileErstellt eine Verknüpfung mit der angegebenen Drive-Element-ID und dem Ressourcenschlüssel und gibt sie zurück.
getAccess(email)PermissionRuft die Berechtigung ab, die einem bestimmten Nutzer gewährt wurde.
getAccess(user)PermissionRuft die Berechtigung ab, die einem bestimmten Nutzer gewährt wurde.
getDateCreated()DateDas Datum, an dem die Folder erstellt wurde.
getDescription()StringRuft die Beschreibung für die Folder ab.
getEditors()User[]Ruft die Liste der Mitbearbeiter für diese Folder ab.
getFiles()FileIteratorRuft eine Sammlung aller Dateien ab, die untergeordnete Elemente des aktuellen Ordners sind.
getFilesByName(name)FileIteratorRuft eine Sammlung aller Dateien ab, die dem aktuellen Ordner untergeordnet sind und den angegebenen Namen haben.
getFilesByType(mimeType)FileIteratorRuft eine Sammlung aller Dateien ab, die dem aktuellen Ordner untergeordnet sind und den angegebenen MIME-Typ haben.
getFolders()FolderIteratorRuft eine Sammlung aller Ordner ab, die untergeordnet zum aktuellen Ordner sind.
getFoldersByName(name)FolderIteratorRuft eine Sammlung aller Ordner ab, die dem aktuellen Ordner untergeordnet sind und den angegebenen Namen haben.
getId()StringRuft die ID der Folder ab.
getLastUpdated()DateDas Datum, an dem die Folder zuletzt aktualisiert wurde.
getName()StringRuft den Namen der Folder ab.
getOwner()UserRuft den Eigentümer dieser Folder ab.
getParents()FolderIteratorEine Sammlung von Ordnern wird abgerufen, die unmittelbar übergeordnete Elemente von Folder sind.
getResourceKey()StringRuft den Ressourcenschlüssel der Folder ab, der zum Zugriff auf Elemente erforderlich ist, die über einen Link freigegeben wurden.
getSecurityUpdateEligible()BooleanGibt an, ob für diese Folder das Sicherheitsupdate angewendet werden kann, für das ein Ressourcenschlüssel für den Zugriff erforderlich ist, wenn die Datei über einen Link freigegeben wird.
getSecurityUpdateEnabled()BooleanGibt an, ob für diese Folder ein Ressourcenschlüssel für den Zugriff erforderlich ist, wenn sie über einen Link freigegeben wird.
getSharingAccess()AccessGibt an, welche Nutzergruppe neben einzelnen Nutzern, denen explizit Zugriff gewährt wurde, auf das Folder zugreifen kann.
getSharingPermission()PermissionRuft die Berechtigung ab, die den Nutzern gewährt wurde, die auf die Folder zugreifen können, sowie die Berechtigung einzelner Nutzer, denen explizit Zugriff gewährt wurde.
getSize()IntegerDie Anzahl der Byte, die zum Speichern der Folder in Drive verwendet werden.
getUrl()StringDie URL, mit der die Folder in einer Google-App wie Drive oder Docs geöffnet werden kann.
getViewers()User[]Ruft die Liste der Betrachter und Kommentatoren für diese Folder ab.
isShareableByEditors()BooleanBestimmt, ob Nutzer mit Bearbeitungsberechtigungen für die Folder die Inhalte für andere Nutzer freigeben oder die Berechtigungen ändern dürfen.
isStarred()BooleanGibt an, ob die Folder im Drive des Nutzers mit einem Stern markiert wurde.
isTrashed()BooleanBestimmt, ob sich die Folder im Papierkorb des Nutzers in Google Drive befindet.
moveTo(destination)FolderVerschiebt dieses Element in den angegebenen Zielordner.
removeEditor(emailAddress)FolderDer angegebene Nutzer wird aus der Liste der Mitbearbeiter der Folder entfernt.
removeEditor(user)FolderDer angegebene Nutzer wird aus der Liste der Mitbearbeiter der Folder entfernt.
removeViewer(emailAddress)FolderDer angegebene Nutzer wird aus der Liste der Zuschauer und Kommentatoren für die Folder entfernt.
removeViewer(user)FolderDer angegebene Nutzer wird aus der Liste der Zuschauer und Kommentatoren für die Folder entfernt.
revokePermissions(emailAddress)FolderHiermit wird der dem Nutzer gewährte Zugriff auf Folder widerrufen.
revokePermissions(user)FolderHiermit wird der dem Nutzer gewährte Zugriff auf Folder widerrufen.
searchFiles(params)FileIteratorRuft eine Sammlung aller Dateien ab, die untergeordnete Elemente des aktuellen Ordners sind und den angegebenen Suchkriterien entsprechen.
searchFolders(params)FolderIteratorRuft eine Sammlung aller Ordner ab, die untergeordnet zum aktuellen Ordner sind und den angegebenen Suchkriterien entsprechen.
setDescription(description)FolderLegt die Beschreibung für die Folder fest.
setName(name)FolderLegt den Namen der Folder fest.
setOwner(emailAddress)FolderÄndert den Inhaber der Folder.
setOwner(user)FolderÄndert den Inhaber der Folder.
setSecurityUpdateEnabled(enabled)FolderLegt fest, ob für den Zugriff auf die Folder ein Ressourcenschlüssel erforderlich ist, wenn sie über einen Link freigegeben wird.
setShareableByEditors(shareable)FolderHier legen Sie fest, ob Nutzer mit Bearbeitungsberechtigungen für die Folder die Inhalte für andere Nutzer freigeben oder die Berechtigungen ändern dürfen.
setSharing(accessType, permissionType)FolderHier wird festgelegt, welche Nutzergruppe auf die Folder zugreifen kann und welche Berechtigungen diesen Nutzern gewährt werden, zusätzlich zu einzelnen Nutzern, die ausdrücklich Zugriff erhalten haben.
setStarred(starred)FolderGibt an, ob die Folder im Drive des Nutzers mit einem Stern markiert ist.
setTrashed(trashed)FolderGibt an, ob sich die Folder im Papierkorb des Drive-Kontos des Nutzers befindet.

Detaillierte Dokumentation

addEditor(emailAddress)

Der angegebene Nutzer wird der Liste der Mitbearbeiter für die Folder hinzugefügt. Wenn der Nutzer bereits auf der Liste der Zuschauer stand, wird er durch diese Methode aus der Liste entfernt.

Parameter

NameTypBeschreibung
emailAddressStringDie E-Mail-Adresse des Nutzers, den Sie hinzufügen möchten.

Rückflug

Folder – Dieses Folder für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

addEditor(user)

Der angegebene Nutzer wird der Liste der Mitbearbeiter für die Folder hinzugefügt. Wenn der Nutzer bereits in der Liste der Zuschauer stand, wird er durch diese Methode aus der Liste entfernt.

Parameter

NameTypBeschreibung
userUserEine Darstellung des hinzuzufügenden Nutzers.

Rückflug

Folder – Dieses Folder für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

addEditors(emailAddresses)

Fügt der Liste der Mitbearbeiter für die Folder das angegebene Nutzerarray hinzu. Wenn sich einer der Nutzer bereits in der Liste der Zuschauer befand, wird er durch diese Methode aus der Liste entfernt.

Parameter

NameTypBeschreibung
emailAddressesString[]Ein Array mit den E-Mail-Adressen der Nutzer, die hinzugefügt werden sollen.

Rückflug

Folder – Dieses Folder für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

addViewer(emailAddress)

Der angegebene Nutzer wird der Liste der Zuschauer für die Folder hinzugefügt. Wenn der Nutzer bereits in der Liste der Mitbearbeiter aufgeführt war, hat diese Methode keine Auswirkungen.

Parameter

NameTypBeschreibung
emailAddressStringDie E-Mail-Adresse des Nutzers, den Sie hinzufügen möchten.

Rückflug

Folder – Dieses Folder für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

addViewer(user)

Der angegebene Nutzer wird der Liste der Zuschauer für die Folder hinzugefügt. Wenn der Nutzer bereits in der Liste der Mitbearbeiter aufgeführt war, hat diese Methode keine Auswirkungen.

Parameter

NameTypBeschreibung
userUserEine Darstellung des hinzuzufügenden Nutzers.

Rückflug

Folder – Dieses Folder für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

addViewers(emailAddresses)

Fügen Sie der Liste der Zuschauer für die Folder das angegebene Array von Nutzern hinzu. Wenn einer der Nutzer bereits in der Liste der Mitbearbeiter aufgeführt war, hat diese Methode keine Auswirkungen auf ihn.

Parameter

NameTypBeschreibung
emailAddressesString[]Ein Array mit den E-Mail-Adressen der Nutzer, die hinzugefügt werden sollen.

Rückflug

Folder – Dieses Folder für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

createFile(blob)

Erstellt eine Datei im aktuellen Ordner aus einer angegebenen Blob mit beliebigen Daten.

Parameter

NameTypBeschreibung
blobBlobSourceDie Daten für die neue Datei.

Rückflug

File: Die neue Datei.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

createFile(name, content)

Erstellt eine Textdatei im aktuellen Ordner mit dem angegebenen Namen und Inhalt. Es wird eine Ausnahme ausgelöst, wenn content größer als 50 MB ist.

// Create a text file with the content "Hello, world!"
DriveApp.getRootFolder().createFile('New Text File', 'Hello, world!');

Parameter

NameTypBeschreibung
nameStringDer Name der neuen Datei.
contentStringDer Inhalt der neuen Datei.

Rückflug

File: Die neue Datei.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

createFile(name, content, mimeType)

Erstellt eine Datei im aktuellen Ordner mit dem angegebenen Namen, Inhalt und MIME-Typ. Es wird eine Ausnahme ausgelöst, wenn content größer als 10 MB ist.

// Create an HTML file with the content "Hello, world!"
DriveApp.getRootFolder().createFile('New HTML File', '<b>Hello, world!</b>', MimeType.HTML);

Parameter

NameTypBeschreibung
nameStringDer Name der neuen Datei.
contentStringDer Inhalt der neuen Datei.
mimeTypeStringDer MIME-Typ der neuen Datei.

Rückflug

File: Die neue Datei.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

createFolder(name)

Erstellt einen Ordner im aktuellen Ordner mit dem angegebenen Namen.

Parameter

NameTypBeschreibung
nameStringDer Name des neuen Ordners.

Rückflug

Folder: Der neue Ordner.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

createShortcut(targetId)

Erstellt eine Verknüpfung zur angegebenen Drive-Element-ID und gibt sie zurück.

Parameter

NameTypBeschreibung
targetIdStringDie Datei-ID der Zieldatei oder des Zielordners.

Rückflug

File: Die neue Verknüpfung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)

Erstellt eine Verknüpfung mit der angegebenen Drive-Element-ID und dem Ressourcenschlüssel und gibt sie zurück. Ein Ressourcenschlüssel ist ein zusätzlicher Parameter, der für den Zugriff auf die Zieldatei oder den Zielordner übergeben werden muss, die bzw. der über einen Link freigegeben wurde.

// Creates shortcuts for all folders in the user's drive that have a specific
// name.
// TODO(developer): Replace 'Test-Folder' with a valid folder name in your
// drive.
const folders = DriveApp.getFoldersByName('Test-Folder');

// Iterates through all folders named 'Test-Folder'.
while (folders.hasNext()) {
  const folder = folders.next();

  // Creates a shortcut to the provided Drive item ID and resource key, and
  // returns it.
  DriveApp.createShortcutForTargetIdAndResourceKey(
      folder.getId(),
      folder.getResourceKey(),
  );
}

Parameter

NameTypBeschreibung
targetIdStringDie ID der Zieldatei oder des Zielordners.
targetResourceKeyStringDer Ressourcenschlüssel der Zieldatei oder des Zielordners.

Rückflug

File: Die neue Verknüpfung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

getAccess(email)

Ruft die Berechtigung ab, die einem bestimmten Nutzer gewährt wurde. Die Methode unterstützt nicht die Rückgabe von Berechtigungen für eine Google-Gruppe oder von Berechtigungen, die über Google-Gruppen übernommen wurden.

Parameter

NameTypBeschreibung
emailStringDie E-Mail-Adresse des Nutzers, dessen Berechtigungen geprüft werden sollen. Google Groups wird nicht unterstützt.

Rückflug

Permission: Die dem Nutzer gewährten Berechtigungen.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getAccess(user)

Ruft die Berechtigung ab, die einem bestimmten Nutzer gewährt wurde. Die Methode unterstützt nicht die Rückgabe von Berechtigungen für eine Google-Gruppe oder von Berechtigungen, die über Google-Gruppen übernommen wurden.

Parameter

NameTypBeschreibung
userUserEine Darstellung des Nutzers, dessen Berechtigungen geprüft werden sollen.

Rückflug

Permission: Die dem Nutzer gewährten Berechtigungen.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getDateCreated()

Das Datum, an dem die Folder erstellt wurde.

Rückflug

Date – das Datum, an dem die Folder erstellt wurde

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getDescription()

Ruft die Beschreibung für die Folder ab.

Rückflug

String: Beschreibung der Folder

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getEditors()

Ruft die Liste der Mitbearbeiter für diese Folder ab. Wenn der Nutzer, der das Script ausführt, keinen Bearbeitungszugriff auf die Folder hat, gibt diese Methode ein leeres Array zurück.

//  Gets a folder by its ID.
//  TODO(developer): Replace the folder ID with your own.
const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz');

// Gets the list of editors and logs their names to the console.
const editors = folder.getEditors();
for (const editor of editors) {
  console.log(editor.getName());
}

Rückflug

User[]: Die Liste der Bearbeiter für diese Folder, wenn der Nutzer Bearbeitungszugriff hat, andernfalls ein leeres Array.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getFiles()

Ruft eine Sammlung aller Dateien ab, die untergeordnete Elemente des aktuellen Ordners sind.

Rückflug

FileIterator: Eine Sammlung aller Dateien, die dem aktuellen Ordner untergeordnet sind.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getFilesByName(name)

Ruft eine Sammlung aller Dateien ab, die dem aktuellen Ordner untergeordnet sind und den angegebenen Namen haben.

Parameter

NameTypBeschreibung
nameStringDer Name der zu suchenden Dateien.

Rückflug

FileIterator: Eine Sammlung aller Dateien, die untergeordnete Elemente des aktuellen Ordners sind und den angegebenen Namen haben.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getFilesByType(mimeType)

Ruft eine Sammlung aller Dateien ab, die dem aktuellen Ordner untergeordnet sind und den angegebenen MIME-Typ haben.

Parameter

NameTypBeschreibung
mimeTypeStringDer MIME-Typ der zu findenden Dateien.

Rückflug

FileIterator: Eine Sammlung aller Dateien, die untergeordnete Elemente des aktuellen Ordners sind und den angegebenen MIME-Typ haben.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getFolders()

Ruft eine Sammlung aller Ordner ab, die untergeordnet zum aktuellen Ordner sind.

Rückflug

FolderIterator: Eine Sammlung aller Ordner, die dem aktuellen Ordner untergeordnet sind.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getFoldersByName(name)

Ruft eine Sammlung aller Ordner ab, die dem aktuellen Ordner untergeordnet sind und den angegebenen Namen haben.

Parameter

NameTypBeschreibung
nameStringDer Name der zu suchenden Ordner.

Rückflug

FolderIterator: Eine Sammlung aller Ordner, die untergeordnete Ordner des aktuellen Ordners sind und den angegebenen Namen haben.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getId()

Ruft die ID der Folder ab.

Rückflug

String: die ID des Folder

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getLastUpdated()

Das Datum, an dem die Folder zuletzt aktualisiert wurde.

Rückflug

Date – das Datum, an dem die Folder zuletzt aktualisiert wurde

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getName()

Ruft den Namen der Folder ab.

Rückflug

String – der Name der Folder

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getOwner()

Ruft den Eigentümer dieser Folder ab.

//  Gets a folder by its ID.
//  TODO(developer): Replace the folder ID with your own.
const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz');

// Gets the owner of the folder and logs the name to the console.
const folderOwner = folder.getOwner();
console.log(folderOwner.getName());

Rückflug

User: Der Inhaber dieser Folder.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getParents()

Eine Sammlung von Ordnern wird abgerufen, die unmittelbar übergeordnete Elemente von Folder sind.

Rückflug

FolderIterator: Eine Sammlung von Ordnern, die unmittelbar übergeordnete Ordner des Folder sind

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getResourceKey()

Ruft den Ressourcenschlüssel der Folder ab, der zum Zugriff auf Elemente erforderlich ist, die über einen Link freigegeben wurden.

Rückflug

String: Der Ressourcenschlüssel der Folder.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getSecurityUpdateEligible()

Gibt an, ob für diese Folder das Sicherheitsupdate angewendet werden kann, für das ein Ressourcenschlüssel für den Zugriff erforderlich ist, wenn die Datei über einen Link freigegeben wird.

Für den Zugriff auf einige Dateien oder Ordner, die über einen Link freigegeben wurden, ist in Google Drive ein Ressourcenschlüssel erforderlich. Diese Änderung ist Teil eines Sicherheitsupdates. Die Funktion ist für berechtigte Dateien und Ordner standardmäßig aktiviert. Mit setSecurityUpdateEnabled können Sie die Anforderung für Ressourcenschlüssel für berechtigte Dateien aktivieren oder deaktivieren.

Weitere Informationen zum Sicherheitsupdate für Google Drive

Rückflug

Boolean: Gibt an, ob die Anforderung für den Ressourcenschlüssel auf die Folder angewendet werden kann.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getSecurityUpdateEnabled()

Gibt an, ob für diese Folder ein Ressourcenschlüssel für den Zugriff erforderlich ist, wenn sie über einen Link freigegeben wird. Diese Anforderung ist für berechtigte Dateien und Ordner standardmäßig aktiviert. Mit setSecurityUpdateEnabled können Sie die Anforderung für Ressourcenschlüssel für berechtigte Dateien aktivieren oder deaktivieren.

Weitere Informationen zum Sicherheitsupdate für Google Drive

Rückflug

Boolean: Gibt an, ob die Anforderung für den Ressourcenschlüssel für diese Folder aktiviert ist.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getSharingAccess()

Gibt an, welche Nutzergruppe neben einzelnen Nutzern, denen explizit Zugriff gewährt wurde, auf das Folder zugreifen kann.

Rückflug

Access – die Nutzergruppe, die auf die Folder zugreifen kann

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getSharingPermission()

Ruft die Berechtigung ab, die Nutzern gewährt wurde, die auf die Folder zugreifen können, sowie die Berechtigung einzelner Nutzer, denen explizit Zugriff gewährt wurde.

Rückflug

Permission: Berechtigungen, die Nutzern gewährt werden, die auf die Folder zugreifen können

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getSize()

Die Anzahl der Byte, die zum Speichern der Folder in Drive verwendet werden. Google Workspace-Anwendungsdateien werden nicht auf die Speicherlimits von Google Drive angerechnet und es werden daher 0 Byte zurückgegeben.

Rückflug

Integer – die Anzahl der Byte, die zum Speichern der Folder in Drive verwendet werden

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getUrl()

Ruft die URL ab, mit der die Folder in einer Google-App wie Drive oder Docs geöffnet werden kann.

Rückflug

String: Die URL, über die diese Folder in einer Google-App wie Drive oder Docs angezeigt werden kann

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getViewers()

Ruft die Liste der Betrachter und Kommentatoren für diese Folder ab. Wenn der Nutzer, der das Script ausführt, keinen Bearbeitungszugriff auf Folder hat, gibt diese Methode ein leeres Array zurück.

//  Gets a folder by its ID.
//  TODO(developer): Replace the folder ID with your own.
const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz');

// Gets the list of viewers and logs their names to the console.
const viewers = folder.getViewers();
for (const viewer of viewers) {
  console.log(viewer.getName());
}

Rückflug

User[]: Die Liste der Betrachter und Kommentatoren für diese Folder, wenn der Nutzer Bearbeitungszugriff hat, andernfalls ein leeres Array.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

isShareableByEditors()

Bestimmt, ob Nutzer mit Bearbeitungsberechtigungen für die Folder die Inhalte für andere Nutzer freigeben oder die Berechtigungen ändern dürfen.

Rückflug

Boolean – true, wenn Nutzer mit Bearbeitungsberechtigungen die Möglichkeit haben, Inhalte für andere Nutzer freizugeben oder die Berechtigungen zu ändern; false, wenn nicht

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

isStarred()

Gibt an, ob die Folder im Drive des Nutzers mit einem Stern markiert wurde.

Rückflug

Boolean – true, wenn die Folder in Google Drive mit einem Stern markiert ist; false andernfalls

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

isTrashed()

Bestimmt, ob sich die Folder im Papierkorb des Nutzers in Google Drive befindet.

Rückflug

Boolean – true, wenn sich die Folder im Papierkorb des Nutzers in Google Drive befindet; false, wenn nicht

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

moveTo(destination)

Verschiebt dieses Element in den angegebenen Zielordner.

Der aktuelle Nutzer muss der Eigentümer der Datei sein oder mindestens Bearbeitungszugriff auf den aktuellen übergeordneten Ordner des Elements haben, um das Element in den Zielordner zu verschieben.

Parameter

NameTypBeschreibung
destinationFolderDer Ordner, der zum neuen übergeordneten Element wird.

Rückflug

Folder – Dieses Folder für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

removeEditor(emailAddress)

Der angegebene Nutzer wird aus der Liste der Mitbearbeiter der Folder entfernt. Mit dieser Methode wird der Zugriff von Nutzern auf die Folder nicht blockiert, wenn sie zu einer Gruppe von Nutzern mit allgemeinem Zugriff gehören. Das ist beispielsweise der Fall, wenn die Folder für die gesamte Domain des Nutzers freigegeben wurde oder sich die Folder in einer geteilten Ablage befindet, auf die der Nutzer zugreifen kann.

Bei Drive-Dateien wird der Nutzer dadurch auch aus der Liste der Betrachter entfernt.

Parameter

NameTypBeschreibung
emailAddressStringDie E-Mail-Adresse des Nutzers, der entfernt werden soll.

Rückflug

Folder – Dieses Folder für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

removeEditor(user)

Der angegebene Nutzer wird aus der Liste der Mitbearbeiter der Folder entfernt. Mit dieser Methode wird der Zugriff von Nutzern auf die Folder nicht blockiert, wenn sie zu einer Gruppe von Nutzern mit allgemeinem Zugriff gehören. Das ist beispielsweise der Fall, wenn die Folder für die gesamte Domain des Nutzers freigegeben wurde oder sich die Folder in einer geteilten Ablage befindet, auf die der Nutzer zugreifen kann.

Bei Drive-Dateien wird der Nutzer dadurch auch aus der Liste der Betrachter entfernt.

Parameter

NameTypBeschreibung
userUserEine Darstellung des zu entfernenden Nutzers.

Rückflug

Folder – Dieses Folder für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

removeViewer(emailAddress)

Der angegebene Nutzer wird aus der Liste der Zuschauer und Kommentatoren für die Folder entfernt. Diese Methode hat keine Auswirkungen, wenn der Nutzer ein Mitbearbeiter und kein Betrachter oder Kommentator ist. Außerdem wird mit dieser Methode der Zugriff von Nutzern auf die Folder nicht blockiert, wenn sie zu einer Gruppe von Nutzern mit allgemeinem Zugriff gehören. Das ist beispielsweise der Fall, wenn die Folder für die gesamte Domain des Nutzers freigegeben wurde oder sich die Folder in einer geteilten Ablage befindet, auf die der Nutzer zugreifen kann.Folder

Bei Drive-Dateien wird der Nutzer auch aus der Liste der Mitbearbeiter entfernt.

Parameter

NameTypBeschreibung
emailAddressStringDie E-Mail-Adresse des Nutzers, der entfernt werden soll.

Rückflug

Folder – Dieses Folder für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

removeViewer(user)

Der angegebene Nutzer wird aus der Liste der Zuschauer und Kommentatoren für die Folder entfernt. Diese Methode hat keine Auswirkungen, wenn der Nutzer ein Mitbearbeiter und kein Betrachter ist. Außerdem wird mit dieser Methode der Zugriff von Nutzern auf die Folder nicht blockiert, wenn sie zu einer Gruppe von Nutzern mit allgemeinem Zugriff gehören. Das ist beispielsweise der Fall, wenn die Folder für die gesamte Domain des Nutzers freigegeben ist oder sich die Folder in einer geteilten Ablage befindet, auf die der Nutzer zugreifen kann.

Bei Drive-Dateien wird der Nutzer auch aus der Liste der Mitbearbeiter entfernt.

Parameter

NameTypBeschreibung
userUserEine Darstellung des zu entfernenden Nutzers.

Rückflug

Folder – Dieses Folder für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

revokePermissions(emailAddress)

Hiermit wird der dem Nutzer gewährte Zugriff auf Folder widerrufen. Mit dieser Methode wird der Zugriff von Nutzern auf die Folder nicht blockiert, wenn sie zu einer Gruppe von Nutzern mit allgemeinem Zugriff gehören. Das ist beispielsweise der Fall, wenn die Folder für die gesamte Domain des Nutzers freigegeben ist.

Parameter

NameTypBeschreibung
emailAddressStringDie E-Mail-Adresse des Nutzers, dessen Zugriff widerrufen werden soll.

Rückflug

Folder – Dieses Folder für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

revokePermissions(user)

Hiermit wird der dem Nutzer gewährte Zugriff auf Folder widerrufen. Mit dieser Methode wird der Zugriff von Nutzern auf die Folder nicht blockiert, wenn sie zu einer Gruppe von Nutzern mit allgemeinem Zugriff gehören. Das ist beispielsweise der Fall, wenn die Folder für die gesamte Domain des Nutzers freigegeben wurde.

Parameter

NameTypBeschreibung
userUserEine Darstellung des Nutzers, dessen Zugriff widerrufen werden soll.

Rückflug

Folder – Dieses Folder für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

searchFiles(params)

Ruft eine Sammlung aller Dateien ab, die untergeordnete Elemente des aktuellen Ordners sind und den angegebenen Suchkriterien entsprechen. Die Suchkriterien werden in der Google Drive SDK-Dokumentation beschrieben. Der Drive-Dienst verwendet Version 2 der Drive API. Einige Abfragefelder unterscheiden sich von Version 3. Weitere Informationen zu den Unterschieden zwischen Version 2 und Version 3

Das Argument params ist ein Abfragestring, der Stringwerte enthalten kann. Achten Sie daher darauf, Anführungszeichen korrekt zu escapen (z. B. "title contains 'Gulliver\\'s Travels'" oder 'title contains "Gulliver\'s Travels"').

// Logs the name of every file that are children of the current folder and modified after February 28,
// 2022 whose name contains "untitled.""
const files = DriveApp.getRootFolder().searchFiles(
    'modifiedDate > "2022-02-28" and title contains "untitled"');
while (files.hasNext()) {
  const file = files.next();
  console.log(file.getName());
}

Parameter

NameTypBeschreibung
paramsStringDie Suchkriterien, wie in der Google Drive SDK-Dokumentation beschrieben.

Rückflug

FileIterator: Eine Sammlung aller Dateien, die untergeordnete Elemente des aktuellen Ordners sind und den Suchkriterien entsprechen.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

searchFolders(params)

Ruft eine Sammlung aller Ordner ab, die untergeordnet zum aktuellen Ordner sind und den angegebenen Suchkriterien entsprechen. Die Suchkriterien werden in der Google Drive SDK-Dokumentation beschrieben. Der Drive-Dienst verwendet Version 2 der Drive API. Einige Abfragefelder unterscheiden sich von Version 3. Weitere Informationen zu den Unterschieden zwischen Version 2 und Version 3

Das Argument params ist ein Abfragestring, der Stringwerte enthalten kann. Achten Sie daher darauf, Anführungszeichen korrekt zu escapen (z. B. "title contains 'Gulliver\\'s Travels'" oder 'title contains "Gulliver\'s Travels"').

// Logs the name of every folder that are children of the current folder and you own and is starred.
const folders = DriveApp.getRootFolder().searchFolders('starred = true and "me" in owners');
while (folders.hasNext()) {
  const folder = folders.next();
  console.log(folder.getName());
}

Parameter

NameTypBeschreibung
paramsStringDie Suchkriterien, wie in der Google Drive SDK-Dokumentation beschrieben.

Rückflug

FolderIterator: Eine Sammlung aller Ordner, die untergeordnet zum aktuellen Ordner sind und den Suchkriterien entsprechen.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

setDescription(description)

Legt die Beschreibung für die Folder fest.

Parameter

NameTypBeschreibung
descriptionStringdie neue Beschreibung für die Folder

Rückflug

Folder – dieses Folder für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

setName(name)

Legt den Namen der Folder fest.

Parameter

NameTypBeschreibung
nameStringden neuen Namen der Folder

Rückflug

Folder – dieses Folder für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

setOwner(emailAddress)

Ändert den Inhaber der Folder. Mit dieser Methode erhält der bisherige Inhaber auch ausdrücklichen Bearbeitungszugriff auf die Folder.

Parameter

NameTypBeschreibung
emailAddressStringdie E-Mail-Adresse des Nutzers, der der neue Inhaber werden soll

Rückflug

Folder – dieses Folder für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

setOwner(user)

Ändert den Inhaber der Folder. Mit dieser Methode erhält der bisherige Inhaber auch ausdrücklichen Bearbeitungszugriff auf die Folder.

Parameter

NameTypBeschreibung
userUsereine Darstellung des Nutzers, der der neue Inhaber werden soll

Rückflug

Folder – dieses Folder für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

setSecurityUpdateEnabled(enabled)

Legt fest, ob für den Zugriff auf die Folder ein Ressourcenschlüssel erforderlich ist, wenn sie über einen Link freigegeben wird. Geeignete Dateien und Ordner sind standardmäßig aktiviert.

Weitere Informationen zum Sicherheitsupdate für Google Drive

Parameter

NameTypBeschreibung
enabledBooleanOb die Anforderung für den Ressourcenschlüssel für die Folder aktiviert werden soll.

Rückflug

Folder – Dieses Folder für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

setShareableByEditors(shareable)

Hier legen Sie fest, ob Nutzer mit Bearbeitungsberechtigungen für die Folder die Inhalte für andere Nutzer freigeben oder die Berechtigungen ändern dürfen. Der Standardwert für eine neue Folder ist true.

Parameter

NameTypBeschreibung
shareableBooleantrue, ob Nutzer mit Bearbeitungsberechtigungen die Möglichkeit haben sollen, die Datei für andere Nutzer freizugeben oder die Berechtigungen zu ändern; false, wenn nicht

Rückflug

Folder – dieses Folder für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

setSharing(accessType, permissionType)

Hier wird festgelegt, welche Nutzergruppe auf die Folder zugreifen kann und welche Berechtigungen diesen Nutzern gewährt werden, zusätzlich zu einzelnen Nutzern, die ausdrücklich Zugriff erhalten haben.

// Creates a folder that anyone on the Internet can read from and write to.
// (Domain administrators can prohibit this setting for users of a Google
// Workspace domain.)
const folder = DriveApp.createFolder('Shared Folder');
folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);

Parameter

NameTypBeschreibung
accessTypeAccessWelche Nutzergruppe sollte auf die Folder
permissionTypePermissiondie Berechtigungen, die Nutzern gewährt werden sollen, die auf die Folder zugreifen können

Rückflug

Folder – dieses Folder für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

setStarred(starred)

Gibt an, ob die Folder im Drive des Nutzers mit einem Stern markiert ist. Der Standardwert für neue Folders ist false.

Parameter

NameTypBeschreibung
starredBooleantrue, wenn die Folder in Google Drive des Nutzers mit einem Stern markiert werden soll; false andernfalls

Rückflug

Folder – dieses Folder für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

setTrashed(trashed)

Gibt an, ob sich die Folder im Papierkorb des Drive-Kontos des Nutzers befindet. Nur der Eigentümer kann die Folder in den Papierkorb verschieben. Der Standardwert für neue Folders ist false.

Parameter

NameTypBeschreibung
trashedBooleantrue, wenn die Folder in den Papierkorb des Drive-Kontos des Nutzers verschoben werden soll, false andernfalls

Rückflug

Folder – dieses Folder für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

Eingestellte Methoden