Class Folder

Ordner

Ein Ordner in Google Drive. Ordner können über DriveApp aufgerufen oder erstellt werden.

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

Methoden

MethodeRückgabetypKurzbeschreibung
addEditor(emailAddress)FolderFügt den angegebenen Nutzer der Liste der Bearbeiter für Folder hinzu.
addEditor(user)FolderFügt den angegebenen Nutzer der Liste der Bearbeiter für Folder hinzu.
addEditors(emailAddresses)FolderFügt das angegebene Array von Nutzern der Liste der Bearbeiter für Folder hinzu.
addViewer(emailAddress)FolderFügt den angegebenen Nutzer der Liste der Betrachter für Folder hinzu.
addViewer(user)FolderFügt den angegebenen Nutzer der Liste der Betrachter für Folder hinzu.
addViewers(emailAddresses)FolderFügt das angegebene Array von Nutzern der Liste der Betrachter für Folder hinzu.
createFile(blob)FileErstellt im aktuellen Ordner eine Datei aus einem gegebenen Blob mit beliebigen Daten.
createFile(name, content)FileErstellt im aktuellen Ordner eine Textdatei mit dem angegebenen Namen und Inhalt.
createFile(name, content, mimeType)FileErstellt im aktuellen Ordner eine Datei 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 zur angegebenen Drive-Element-ID und dem Ressourcenschlüssel und gibt sie zurück.
getAccess(email)PermissionRuft die Berechtigung ab, die dem angegebenen Nutzer gewährt wurde.
getAccess(user)PermissionRuft die Berechtigung ab, die dem angegebenen Nutzer gewährt wurde.
getDateCreated()DateRuft das Datum ab, an dem Folder erstellt wurde.
getDescription()StringRuft die Beschreibung für Folder ab.
getEditors()User[]Ruft die Liste der Bearbeiter für diesen Folder ab.
getFiles()FileIteratorRuft eine Sammlung aller Dateien ab, die dem aktuellen Ordner untergeordnet 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 dem aktuellen Ordner untergeordnet sind.
getFoldersByName(name)FolderIteratorRuft eine Sammlung aller Ordner ab, die dem aktuellen Ordner untergeordnet sind und den angegebenen Namen haben.
getId()StringRuft die ID von Folder ab.
getLastUpdated()DateRuft das Datum ab, an dem Folder zuletzt aktualisiert wurde.
getName()StringRuft den Namen des Folder ab.
getOwner()UserRuft den Eigentümer von Folder ab.
getParents()FolderIteratorRuft eine Sammlung von Ordnern ab, die Folder unmittelbar übergeordnet sind.
getResourceKey()StringRuft den Ressourcenschlüssel von Folder ab, der für den Zugriff auf Elemente erforderlich ist, die über einen Link freigegeben wurden.
getSecurityUpdateEligible()BooleanRuft ab, ob dieser Folder berechtigt ist, das Sicherheitsupdate anzuwenden, das einen Ressourcenschlüssel für den Zugriff erfordert, wenn es über einen Link freigegeben wird.
getSecurityUpdateEnabled()BooleanRuft ab, ob für diesen Folder ein Ressourcenschlüssel für den Zugriff erforderlich ist, wenn er über einen Link freigegeben wird.
getSharingAccess()AccessRuft ab, welche Klasse von Nutzern auf Folder zugreifen kann, ausgenommen einzelne Nutzer, denen explizit Zugriff gewährt wurde.
getSharingPermission()PermissionRuft die Berechtigung für die Nutzer ab, die auf Folder zugreifen können, ausgenommen einzelne Nutzer, denen explizit Zugriff gewährt wurde.
getSize()IntegerRuft die Anzahl der Byte ab, die zum Speichern von Folder in Drive verwendet werden.
getUrl()StringRuft die URL ab, mit der Folder in einer Google-App wie Drive oder Docs geöffnet werden kann.
getViewers()User[]Liste der Betrachter und Kommentatoren für diesen Folder abrufen
isShareableByEditors()BooleanBestimmt, ob Nutzer mit Bearbeitungsberechtigungen für Folder Dateien für andere Nutzer freigeben oder die Berechtigungen ändern dürfen.
isStarred()BooleanErmittelt, ob Folder in der Ablage des Nutzers markiert wurde.
isTrashed()BooleanLegt fest, ob sich das Folder-Element im Papierkorb des Nutzers in der Ablage des Nutzers befindet.
moveTo(destination)FolderVerschiebt dieses Element in den angegebenen Zielordner.
removeEditor(emailAddress)FolderEntfernt den angegebenen Nutzer aus der Liste der Bearbeiter für Folder.
removeEditor(user)FolderEntfernt den angegebenen Nutzer aus der Liste der Bearbeiter für Folder.
removeViewer(emailAddress)FolderEntfernt den angegebenen Nutzer aus der Liste der Betrachter und Kommentatoren für Folder.
removeViewer(user)FolderEntfernt den angegebenen Nutzer aus der Liste der Betrachter und Kommentatoren für Folder.
revokePermissions(emailAddress)FolderHebt den Zugriff auf die Folder auf, die dem jeweiligen Nutzer gewährt wurden.
revokePermissions(user)FolderHebt den Zugriff auf die Folder auf, die dem jeweiligen Nutzer gewährt wurden.
searchFiles(params)FileIteratorRuft eine Sammlung aller Dateien ab, die dem aktuellen Ordner untergeordnet sind und den angegebenen Suchkriterien entsprechen.
searchFolders(params)FolderIteratorRuft eine Sammlung aller Ordner ab, die dem aktuellen Ordner untergeordnet sind und den angegebenen Suchkriterien entsprechen.
setDescription(description)FolderLegt die Beschreibung für Folder fest.
setName(name)FolderLegt den Namen von Folder fest.
setOwner(emailAddress)FolderEigentümer von Folder ändern
setOwner(user)FolderEigentümer von Folder ändern
setSecurityUpdateEnabled(enabled)FolderLegt fest, ob das Folder für den Zugriff einen Ressourcenschlüssel erfordert, wenn es über einen Link freigegeben wird.
setShareableByEditors(shareable)FolderLegt fest, ob Nutzer mit Bearbeitungsberechtigungen für Folder Dateien für andere Nutzer freigeben oder die Berechtigungen ändern dürfen.
setSharing(accessType, permissionType)FolderLegt fest, welche Klasse von Nutzern auf Folder zugreifen kann und welche Berechtigungen diesen Nutzern gewährt werden, abgesehen von einzelnen Nutzern, denen explizit Zugriff gewährt wurde.
setStarred(starred)FolderLegt fest, ob das Folder in der Ablage des Nutzers markiert ist.
setTrashed(trashed)FolderLegt fest, ob sich das Folder-Element im Papierkorb des Nutzers in der Ablage des Nutzers befindet.

Detaillierte Dokumentation

addEditor(emailAddress)

Fügt den angegebenen Nutzer der Liste der Bearbeiter für Folder hinzu. Wenn der Nutzer bereits in der Liste der Betrachter enthalten war, wird er mit dieser Methode aus der Liste der Betrachter herausgestuft.

Parameter

NameTypBeschreibung
emailAddressStringDie E-Mail-Adresse des Nutzers, der hinzugefügt werden soll.

Return

Folder: Dieses Folder für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

addEditor(user)

Fügt den angegebenen Nutzer der Liste der Bearbeiter für Folder hinzu. Wenn der Nutzer bereits in der Liste der Betrachter enthalten war, wird er mit dieser Methode aus der Liste der Betrachter herausgestuft.

Parameter

NameTypBeschreibung
userUserEine Darstellung des hinzuzufügenden Nutzers.

Return

Folder: Dieses Folder für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

addEditors(emailAddresses)

Fügt das angegebene Array von Nutzern der Liste der Bearbeiter für Folder hinzu. Wenn einer der Nutzer bereits in der Liste der Betrachter enthalten war, wird er mit dieser Methode aus der Liste der Betrachter herausgestuft.

Parameter

NameTypBeschreibung
emailAddressesString[]Ein Array mit E-Mail-Adressen der hinzuzufügenden Nutzer.

Return

Folder: Dieses Folder für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

addViewer(emailAddress)

Fügt den angegebenen Nutzer der Liste der Betrachter für Folder hinzu. Wenn sich der Nutzer bereits in der Liste der Bearbeiter befand, hat diese Methode keine Auswirkungen.

Parameter

NameTypBeschreibung
emailAddressStringDie E-Mail-Adresse des Nutzers, der hinzugefügt werden soll.

Return

Folder: Dieses Folder für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

addViewer(user)

Fügt den angegebenen Nutzer der Liste der Betrachter für Folder hinzu. Wenn sich der Nutzer bereits in der Liste der Bearbeiter befand, hat diese Methode keine Auswirkungen.

Parameter

NameTypBeschreibung
userUserEine Darstellung des hinzuzufügenden Nutzers.

Return

Folder: Dieses Folder für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

addViewers(emailAddresses)

Fügt das angegebene Array von Nutzern der Liste der Betrachter für Folder hinzu. Wenn sich Nutzer bereits in der Liste der Bearbeiter befanden, hat diese Methode keine Auswirkungen auf sie.

Parameter

NameTypBeschreibung
emailAddressesString[]Ein Array mit E-Mail-Adressen der hinzuzufügenden Nutzer.

Return

Folder: Dieses Folder für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

createFile(blob)

Erstellt im aktuellen Ordner eine Datei aus einem gegebenen Blob mit beliebigen Daten.

// Create an image file in Google Drive using the Maps service.
var blob = Maps.newStaticMap().setCenter('76 9th Avenue, New York NY').getBlob();
DriveApp.getRootFolder().createFile(blob);

Parameter

NameTypBeschreibung
blobBlobSourceDie Daten für die neue Datei.

Return

File: Die neue Datei.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

createFile(name, content)

Erstellt im aktuellen Ordner eine Textdatei mit dem angegebenen Namen und Inhalt. Löst eine Ausnahme aus, 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.

Return

File: Die neue Datei.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

createFile(name, content, mimeType)

Erstellt im aktuellen Ordner eine Datei mit dem angegebenen Namen, Inhalt und MIME-Typ. Löst eine Ausnahme aus, 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.

Return

File: Die neue Datei.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

createFolder(name)

Erstellt im aktuellen Ordner einen Ordner mit dem angegebenen Namen.

Parameter

NameTypBeschreibung
nameStringDer Name des neuen Ordners.

Return

Folder: Der neue Ordner.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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.

Return

File: Das neue Tastenkürzel.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)

Erstellt eine Verknüpfung zur angegebenen Drive-Element-ID und dem Ressourcenschlüssel und gibt sie zurück. Ein Ressourcenschlüssel ist ein zusätzlicher Parameter, der übergeben werden muss, um auf die Zieldatei oder den Zielordner zuzugreifen, 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.

Return

File: Das neue Tastenkürzel.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getAccess(email)

Ruft die Berechtigung ab, die dem angegebenen Nutzer gewährt wurde.

Parameter

NameTypBeschreibung
emailStringDie E-Mail-Adresse des Nutzers, dessen Berechtigungen überprüft werden sollen

Return

Permission: dem Nutzer gewährte Berechtigungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getAccess(user)

Ruft die Berechtigung ab, die dem angegebenen Nutzer gewährt wurde.

Parameter

NameTypBeschreibung
userUserDarstellung des Nutzers, dessen Berechtigungen überprüft werden sollen

Return

Permission: dem Nutzer gewährte Berechtigungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getDateCreated()

Ruft das Datum ab, an dem Folder erstellt wurde.

Return

Date: Das Datum, an dem die Folder erstellt wurde

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getDescription()

Ruft die Beschreibung für Folder ab.

Return

String – die Beschreibung für Folder

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getEditors()

Ruft die Liste der Bearbeiter für diesen Folder ab. Wenn der Nutzer, der das Skript 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 editors and logs their names to the console.
const editors = folder.getEditors();
for (editor of editors) {
  console.log(editor.getName());
}

Return

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

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getFiles()

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

Return

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

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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.

Return

FileIterator: Eine Sammlung aller Dateien, die dem aktuellen Ordner untergeordnet sind und den angegebenen Namen haben.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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 suchenden Dateien.

Return

FileIterator: Eine Sammlung aller Dateien, die dem aktuellen Ordner untergeordnet sind und den angegebenen MIME-Typ haben.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getFolders()

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

Return

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

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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.

Return

FolderIterator: Eine Sammlung aller Ordner, die dem aktuellen Ordner untergeordnet sind und den angegebenen Namen haben.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getId()

Ruft die ID von Folder ab.

Return

String: die ID von Folder

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getLastUpdated()

Ruft das Datum ab, an dem Folder zuletzt aktualisiert wurde.

Return

Date: Das Datum, an dem die Folder zuletzt aktualisiert wurde

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getName()

Ruft den Namen des Folder ab.

Return

String: der Name von Folder

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getOwner()

Ruft den Eigentümer von 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());

Return

User – Der Inhaber von Folder.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getParents()

Ruft eine Sammlung von Ordnern ab, die Folder unmittelbar übergeordnet sind.

Return

FolderIterator: eine Sammlung von Ordnern, die Folder unmittelbar übergeordnet sind

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getResourceKey()

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

Return

String: Der Ressourcenschlüssel von Folder.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getSecurityUpdateEligible()

Ruft ab, ob dieser Folder berechtigt ist, das Sicherheitsupdate anzuwenden, das einen Ressourcenschlüssel für den Zugriff erfordert, wenn es über einen Link freigegeben wird.

Drive benötigt einen Ressourcenschlüssel für den Zugriff auf einige Dateien oder Ordner, die über einen Link freigegeben wurden. Diese Änderung ist Teil eines Sicherheitsupdates. Das Update ist für zulässige Dateien und Ordner standardmäßig aktiviert. Verwenden Sie setSecurityUpdateEnabled, um die Ressourcenschlüsselanforderung für zulässige Dateien zu aktivieren oder zu deaktivieren.

Weitere Informationen zum Sicherheitsupdate für Google Drive

Return

Boolean: Gibt an, ob die Ressourcenschlüsselanforderung für Folder angewendet werden kann.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getSecurityUpdateEnabled()

Ruft ab, ob für diesen Folder ein Ressourcenschlüssel für den Zugriff erforderlich ist, wenn er über einen Link freigegeben wird. Diese Anforderung ist für infrage kommende Dateien und Ordner standardmäßig aktiviert. Verwenden Sie setSecurityUpdateEnabled, um die Ressourcenschlüsselanforderung für zulässige Dateien zu aktivieren oder zu deaktivieren.

Weitere Informationen zum Sicherheitsupdate für Google Drive

Return

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

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getSharingAccess()

Ruft ab, welche Klasse von Nutzern auf Folder zugreifen kann, ausgenommen einzelne Nutzer, denen explizit Zugriff gewährt wurde.

Return

Access: Welche Klasse von Nutzern auf Folder zugreifen kann

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getSharingPermission()

Ruft die Berechtigung für die Nutzer ab, die auf Folder zugreifen können, ausgenommen einzelne Nutzer, denen explizit Zugriff gewährt wurde.

Return

Permission: Berechtigungen für Nutzer, die auf Folder zugreifen können

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getSize()

Ruft die Anzahl der Byte ab, die zum Speichern von Folder in Drive verwendet werden. Hinweis: Google Workspace-Anwendungsdateien werden nicht auf das Google Drive-Speicherkontingent angerechnet und geben daher 0 Byte zurück.

Return

Integer: Anzahl der Byte zum Speichern von Folder in Drive

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getUrl()

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

Return

String: die URL, mit der dieses Folder in einer Google-App wie Drive oder Docs aufgerufen werden kann

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getViewers()

Liste der Betrachter und Kommentatoren für diesen Folder abrufen Wenn der Nutzer, der das Skript 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 (viewer of viewers) {
  console.log(viewer.getName());
}

Return

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

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

isShareableByEditors()

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

Return

Boolean: true, wenn Nutzer mit Bearbeitungsberechtigungen Dateien für andere Nutzer freigeben oder die Berechtigungen ändern dürfen; false wenn nicht

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

isStarred()

Ermittelt, ob Folder in der Ablage des Nutzers markiert wurde.

Return

Boolean: true, wenn Folder in der Ablage des Nutzers markiert ist; false, wenn nicht

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

isTrashed()

Legt fest, ob sich das Folder-Element im Papierkorb des Nutzers in der Ablage des Nutzers befindet.

Return

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

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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 Eigentümer der Datei sein oder mindestens Bearbeitungszugriff auf den aktuellen übergeordneten Ordner des Elements haben, damit das Element in den Zielordner verschoben werden kann.

Parameter

NameTypBeschreibung
destinationFolderDer Ordner, der zum neuen übergeordneten Element wird

Return

Folder: Dieses Folder für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

removeEditor(emailAddress)

Entfernt den angegebenen Nutzer aus der Liste der Bearbeiter für Folder. Diese Methode verhindert nicht, dass Nutzer auf Folder zugreifen, wenn sie zu einer Klasse von Nutzern mit allgemeinen Zugriff gehören. Das ist z. B. der Fall, wenn Folder für die gesamte Domain des Nutzers freigegeben ist oder wenn sich Folder in einer geteilten Ablage befindet, auf die der Nutzer zugreifen kann.

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

Parameter

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

Return

Folder: Dieses Folder für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

removeEditor(user)

Entfernt den angegebenen Nutzer aus der Liste der Bearbeiter für Folder. Diese Methode verhindert nicht, dass Nutzer auf Folder zugreifen, wenn sie zu einer Klasse von Nutzern mit allgemeinen Zugriff gehören. Das ist z. B. der Fall, wenn Folder für die gesamte Domain des Nutzers freigegeben ist oder wenn sich Folder in einer geteilten Ablage befindet, auf die der Nutzer zugreifen kann.

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

Parameter

NameTypBeschreibung
userUserEine Darstellung des Nutzers, der entfernt werden soll.

Return

Folder: Dieses Folder für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

removeViewer(emailAddress)

Entfernt den angegebenen Nutzer aus der Liste der Betrachter und Kommentatoren für Folder. Diese Methode hat keine Auswirkungen, wenn der Nutzer Bearbeiter und kein Betrachter oder Kommentator ist. Außerdem wird durch diese Methode nicht verhindert, dass Nutzer auf Folder zugreifen, wenn sie zu einer Klasse von Nutzern mit allgemeinem Zugriff gehören, z. B. wenn die Folder für die gesamte Domain des Nutzers freigegeben ist oder wenn sich Folder in einer geteilten Ablage befindet, auf die der Nutzer zugreifen kann.

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

Parameter

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

Return

Folder: Folder für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

removeViewer(user)

Entfernt den angegebenen Nutzer aus der Liste der Betrachter und Kommentatoren für Folder. Diese Methode hat keine Auswirkungen, wenn der Nutzer Bearbeiter und kein Betrachter ist. Außerdem verhindert diese Methode nicht, dass Nutzer auf Folder zugreifen, wenn sie zu einer Klasse von Nutzern mit allgemeinem Zugriff gehören, z. B. wenn Folder für die gesamte Domain des Nutzers freigegeben ist oder wenn sich Folder in einer geteilten Ablage befindet, auf die der Nutzer zugreifen kann.

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

Parameter

NameTypBeschreibung
userUserEine Darstellung des Nutzers, der entfernt werden soll.

Return

Folder: Folder für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

revokePermissions(emailAddress)

Hebt den Zugriff auf die Folder auf, die dem jeweiligen Nutzer gewährt wurden. Diese Methode verhindert nicht, dass Nutzer auf Folder zugreifen, wenn sie zu einer Klasse von Nutzern mit allgemeinen Zugriff gehören. Dies ist beispielsweise dann 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.

Return

Folder: Dieses Folder für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

revokePermissions(user)

Hebt den Zugriff auf die Folder auf, die dem jeweiligen Nutzer gewährt wurden. Diese Methode verhindert nicht, dass Nutzer auf Folder zugreifen, wenn sie zu einer Klasse von Nutzern mit allgemeinen Zugriff gehören. Dies ist beispielsweise dann der Fall, wenn die Folder für die gesamte Domain des Nutzers freigegeben ist.

Parameter

NameTypBeschreibung
userUserDarstellung des Nutzers, dessen Zugriff widerrufen werden soll

Return

Folder: Dieses Folder für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

searchFiles(params)

Ruft eine Sammlung aller Dateien ab, die dem aktuellen Ordner untergeordnet sind und den angegebenen Suchkriterien entsprechen. Die Suchkriterien werden in der Google Drive SDK-Dokumentation ausführlich beschrieben. Hinweis: Der Drive-Dienst verwendet Version 2 der Drive API und einige Abfragefelder unterscheiden sich von Version 3. Sehen Sie sich die Unterschiede zwischen den Feldern in Version 2 und Version 3 an.

Das Argument params ist ein Abfragestring, der Stringwerte enthalten kann. Achten Sie deshalb darauf, Anführungszeichen korrekt zu maskieren (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.""
var files = DriveApp.getRootFolder().searchFiles(
    'modifiedDate > "2022-02-28" and title contains "untitled"');
while (files.hasNext()) {
  var file = files.next();
  console.log(file.getName());
}

Parameter

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

Return

FileIterator: Eine Sammlung aller Dateien, die dem aktuellen Ordner untergeordnet sind und den Suchkriterien entsprechen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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 dem aktuellen Ordner untergeordnet sind und den angegebenen Suchkriterien entsprechen. Die Suchkriterien werden in der Google Drive SDK-Dokumentation ausführlich beschrieben. Hinweis: Der Drive-Dienst verwendet Version 2 der Drive API und einige Abfragefelder unterscheiden sich von Version 3. Sehen Sie sich die Unterschiede zwischen den Feldern in Version 2 und Version 3 an.

Das Argument params ist ein Abfragestring, der Stringwerte enthalten kann. Achten Sie deshalb darauf, Anführungszeichen korrekt zu maskieren (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.
var folders = DriveApp.getRootFolder().searchFolders('starred = true and "me" in owners');
while (folders.hasNext()) {
  var folder = folders.next();
  console.log(folder.getName());
}

Parameter

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

Return

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

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setDescription(description)

Legt die Beschreibung für Folder fest.

Parameter

NameTypBeschreibung
descriptionStringDie neue Beschreibung für Folder

Return

Folder – dieses Folder für Verkettung

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setName(name)

Legt den Namen von Folder fest.

Parameter

NameTypBeschreibung
nameStringden neuen Namen von Folder

Return

Folder – dieses Folder für Verkettung

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setOwner(emailAddress)

Eigentümer von Folder ändern Mit dieser Methode erhält der vorherige Inhaber außerdem expliziten Bearbeitungszugriff auf die Folder.

Parameter

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

Return

Folder – dieses Folder für Verkettung

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setOwner(user)

Eigentümer von Folder ändern Mit dieser Methode erhält der vorherige Inhaber außerdem expliziten Bearbeitungszugriff auf die Folder.

Parameter

NameTypBeschreibung
userUsereine Darstellung des Nutzers, der neuer Inhaber werden soll

Return

Folder – dieses Folder für Verkettung

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setSecurityUpdateEnabled(enabled)

Legt fest, ob das Folder für den Zugriff einen Ressourcenschlüssel erfordert, wenn es über einen Link freigegeben wird. Zulässige Dateien und Ordner sind standardmäßig aktiviert.

Weitere Informationen zum Sicherheitsupdate für Google Drive

Parameter

NameTypBeschreibung
enabledBooleanGibt an, ob die Ressourcenschlüsselanforderung für Folder aktiviert werden soll.

Return

Folder: Dieses Folder für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setShareableByEditors(shareable)

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

Parameter

NameTypBeschreibung
shareableBooleantrue, wenn Nutzer mit Bearbeitungsberechtigungen berechtigt sein sollen, Dateien für andere Nutzer freizugeben oder die Berechtigungen zu ändern; false wenn nicht

Return

Folder – dieses Folder für Verkettung

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setSharing(accessType, permissionType)

Legt fest, welche Klasse von Nutzern auf Folder zugreifen kann und welche Berechtigungen diesen Nutzern gewährt werden, abgesehen von einzelnen Nutzern, denen explizit Zugriff gewährt wurde.

// 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.)
var folder = DriveApp.createFolder('Shared Folder');
folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);

Parameter

NameTypBeschreibung
accessTypeAccesswelche Klasse von Nutzern Zugriff auf Folder haben soll
permissionTypePermissiondie Berechtigungen, die Nutzern gewährt werden sollten, die auf Folder zugreifen können

Return

Folder – dieses Folder für Verkettung

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setStarred(starred)

Legt fest, ob das Folder in der Ablage des Nutzers markiert ist. Der Standardwert für neue Folders ist false.

Parameter

NameTypBeschreibung
starredBooleantrue, wenn Folder in der Ablage des Nutzers markiert werden soll; false wenn nicht

Return

Folder – dieses Folder für Verkettung

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setTrashed(trashed)

Legt fest, ob sich das Folder-Element im Papierkorb des Nutzers in der Ablage des Nutzers befindet. Nur der Inhaber kann Folder in den Papierkorb verschieben. Der Standardwert für neue Folders ist false.

Parameter

NameTypBeschreibung
trashedBooleantrue, wenn Folder in den Papierkorb des Nutzers verschoben werden soll; false andernfalls

Return

Folder – dieses Folder für Verkettung

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Verworfene Methoden