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
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
addEditor(emailAddress) | Folder | Der angegebene Nutzer wird der Liste der Mitbearbeiter für die Folder hinzugefügt. |
addEditor(user) | Folder | Der angegebene Nutzer wird der Liste der Mitbearbeiter für die Folder hinzugefügt. |
addEditors(emailAddresses) | Folder | Fügt der Liste der Mitbearbeiter für die Folder das angegebene Nutzerarray hinzu. |
addViewer(emailAddress) | Folder | Der angegebene Nutzer wird der Liste der Zuschauer für die Folder hinzugefügt. |
addViewer(user) | Folder | Der angegebene Nutzer wird der Liste der Zuschauer für die Folder hinzugefügt. |
addViewers(emailAddresses) | Folder | Fügen Sie der Liste der Zuschauer für die Folder das angegebene Array von Nutzern hinzu. |
createFile(blob) | File | Erstellt eine Datei im aktuellen Ordner aus einer angegebenen Blob mit beliebigen Daten. |
createFile(name, content) | File | Erstellt eine Textdatei im aktuellen Ordner mit dem angegebenen Namen und Inhalt. |
createFile(name, content, mimeType) | File | Erstellt eine Datei im aktuellen Ordner mit dem angegebenen Namen, Inhalt und MIME-Typ. |
createFolder(name) | Folder | Erstellt im aktuellen Ordner einen Ordner mit dem angegebenen Namen. |
createShortcut(targetId) | File | Erstellt eine Verknüpfung zur angegebenen Drive-Element-ID und gibt sie zurück. |
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey) | File | Erstellt eine Verknüpfung mit der angegebenen Drive-Element-ID und dem Ressourcenschlüssel und gibt sie zurück. |
getAccess(email) | Permission | Ruft die Berechtigung ab, die einem bestimmten Nutzer gewährt wurde. |
getAccess(user) | Permission | Ruft die Berechtigung ab, die einem bestimmten Nutzer gewährt wurde. |
getDateCreated() | Date | Das Datum, an dem die Folder erstellt wurde. |
getDescription() | String | Ruft die Beschreibung für die Folder ab. |
getEditors() | User[] | Ruft die Liste der Mitbearbeiter für diese Folder ab. |
getFiles() | FileIterator | Ruft eine Sammlung aller Dateien ab, die untergeordnete Elemente des aktuellen Ordners sind. |
getFilesByName(name) | FileIterator | Ruft eine Sammlung aller Dateien ab, die dem aktuellen Ordner untergeordnet sind und den angegebenen Namen haben. |
getFilesByType(mimeType) | FileIterator | Ruft eine Sammlung aller Dateien ab, die dem aktuellen Ordner untergeordnet sind und den angegebenen MIME-Typ haben. |
getFolders() | FolderIterator | Ruft eine Sammlung aller Ordner ab, die untergeordnet zum aktuellen Ordner sind. |
getFoldersByName(name) | FolderIterator | Ruft eine Sammlung aller Ordner ab, die dem aktuellen Ordner untergeordnet sind und den angegebenen Namen haben. |
getId() | String | Ruft die ID der Folder ab. |
getLastUpdated() | Date | Das Datum, an dem die Folder zuletzt aktualisiert wurde. |
getName() | String | Ruft den Namen der Folder ab. |
getOwner() | User | Ruft den Eigentümer dieser Folder ab. |
getParents() | FolderIterator | Eine Sammlung von Ordnern wird abgerufen, die unmittelbar übergeordnete Elemente von Folder sind. |
getResourceKey() | String | Ruft den Ressourcenschlüssel der Folder ab, der zum Zugriff auf Elemente erforderlich ist, die über einen Link freigegeben wurden. |
getSecurityUpdateEligible() | Boolean | 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. |
getSecurityUpdateEnabled() | Boolean | Gibt an, ob für diese Folder ein Ressourcenschlüssel für den Zugriff erforderlich ist, wenn sie über einen Link freigegeben wird. |
getSharingAccess() | Access | Gibt an, welche Nutzergruppe neben einzelnen Nutzern, denen explizit Zugriff gewährt wurde, auf das Folder zugreifen kann. |
getSharingPermission() | Permission | Ruft 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() | Integer | Die Anzahl der Byte, die zum Speichern der Folder in Drive verwendet werden. |
getUrl() | String | Die 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() | Boolean | Bestimmt, ob Nutzer mit Bearbeitungsberechtigungen für die Folder die Inhalte für andere Nutzer freigeben oder die Berechtigungen ändern dürfen. |
isStarred() | Boolean | Gibt an, ob die Folder im Drive des Nutzers mit einem Stern markiert wurde. |
isTrashed() | Boolean | Bestimmt, ob sich die Folder im Papierkorb des Nutzers in Google Drive befindet. |
moveTo(destination) | Folder | Verschiebt dieses Element in den angegebenen Zielordner. |
removeEditor(emailAddress) | Folder | Der angegebene Nutzer wird aus der Liste der Mitbearbeiter der Folder entfernt. |
removeEditor(user) | Folder | Der angegebene Nutzer wird aus der Liste der Mitbearbeiter der Folder entfernt. |
removeViewer(emailAddress) | Folder | Der angegebene Nutzer wird aus der Liste der Zuschauer und Kommentatoren für die Folder entfernt. |
removeViewer(user) | Folder | Der angegebene Nutzer wird aus der Liste der Zuschauer und Kommentatoren für die Folder entfernt. |
revokePermissions(emailAddress) | Folder | Hiermit wird der dem Nutzer gewährte Zugriff auf Folder widerrufen. |
revokePermissions(user) | Folder | Hiermit wird der dem Nutzer gewährte Zugriff auf Folder widerrufen. |
searchFiles(params) | FileIterator | Ruft eine Sammlung aller Dateien ab, die untergeordnete Elemente des aktuellen Ordners sind und den angegebenen Suchkriterien entsprechen. |
searchFolders(params) | FolderIterator | Ruft eine Sammlung aller Ordner ab, die untergeordnet zum aktuellen Ordner sind und den angegebenen Suchkriterien entsprechen. |
setDescription(description) | Folder | Legt die Beschreibung für die Folder fest. |
setName(name) | Folder | Legt den Namen der Folder fest. |
setOwner(emailAddress) | Folder | Ändert den Inhaber der Folder . |
setOwner(user) | Folder | Ändert den Inhaber der Folder . |
setSecurityUpdateEnabled(enabled) | Folder | Legt fest, ob für den Zugriff auf die Folder ein Ressourcenschlüssel erforderlich ist, wenn sie über einen Link freigegeben wird. |
setShareableByEditors(shareable) | Folder | 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. |
setSharing(accessType, permissionType) | Folder | 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. |
setStarred(starred) | Folder | Gibt an, ob die Folder im Drive des Nutzers mit einem Stern markiert ist. |
setTrashed(trashed) | Folder | Gibt 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
Name | Typ | Beschreibung |
---|---|---|
emailAddress | String | Die 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
Name | Typ | Beschreibung |
---|---|---|
user | User | Eine 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
Name | Typ | Beschreibung |
---|---|---|
emailAddresses | String[] | 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
Name | Typ | Beschreibung |
---|---|---|
emailAddress | String | Die 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
Name | Typ | Beschreibung |
---|---|---|
user | User | Eine 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
Name | Typ | Beschreibung |
---|---|---|
emailAddresses | String[] | 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
Name | Typ | Beschreibung |
---|---|---|
blob | BlobSource | Die 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
Name | Typ | Beschreibung |
---|---|---|
name | String | Der Name der neuen Datei. |
content | String | Der 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
Name | Typ | Beschreibung |
---|---|---|
name | String | Der Name der neuen Datei. |
content | String | Der Inhalt der neuen Datei. |
mimeType | String | Der 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
Name | Typ | Beschreibung |
---|---|---|
name | String | Der 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
Name | Typ | Beschreibung |
---|---|---|
targetId | String | Die 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
Name | Typ | Beschreibung |
---|---|---|
targetId | String | Die ID der Zieldatei oder des Zielordners. |
targetResourceKey | String | Der 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
Name | Typ | Beschreibung |
---|---|---|
email | String | Die 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
Name | Typ | Beschreibung |
---|---|---|
user | User | Eine 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()
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
Name | Typ | Beschreibung |
---|---|---|
name | String | Der 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
Name | Typ | Beschreibung |
---|---|---|
mimeType | String | Der 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
Name | Typ | Beschreibung |
---|---|---|
name | String | Der 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()
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()
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
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
Name | Typ | Beschreibung |
---|---|---|
destination | Folder | Der 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
Name | Typ | Beschreibung |
---|---|---|
emailAddress | String | Die 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
Name | Typ | Beschreibung |
---|---|---|
user | User | Eine 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
Name | Typ | Beschreibung |
---|---|---|
emailAddress | String | Die 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
Name | Typ | Beschreibung |
---|---|---|
user | User | Eine 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
Name | Typ | Beschreibung |
---|---|---|
emailAddress | String | Die 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
Name | Typ | Beschreibung |
---|---|---|
user | User | Eine 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
Name | Typ | Beschreibung |
---|---|---|
params | String | Die 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
Name | Typ | Beschreibung |
---|---|---|
params | String | Die 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
Name | Typ | Beschreibung |
---|---|---|
description | String | die 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
Name | Typ | Beschreibung |
---|---|---|
name | String | den 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
Name | Typ | Beschreibung |
---|---|---|
emailAddress | String | die 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
Name | Typ | Beschreibung |
---|---|---|
user | User | eine 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
Name | Typ | Beschreibung |
---|---|---|
enabled | Boolean | Ob 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
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
Name | Typ | Beschreibung |
---|---|---|
accessType | Access | Welche Nutzergruppe sollte auf die Folder |
permissionType | Permission | die 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 Folder
s ist false
.
Parameter
Name | Typ | Beschreibung |
---|---|---|
starred | Boolean | true , 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 Folder
s ist false
.
Parameter
Name | Typ | Beschreibung |
---|---|---|
trashed | Boolean | true , 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