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
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
addEditor(emailAddress) | Folder | Fügt den angegebenen Nutzer der Liste der Bearbeiter für Folder hinzu. |
addEditor(user) | Folder | Fügt den angegebenen Nutzer der Liste der Bearbeiter für Folder hinzu. |
addEditors(emailAddresses) | Folder | Fügt das angegebene Array von Nutzern der Liste der Bearbeiter für Folder hinzu. |
addViewer(emailAddress) | Folder | Fügt den angegebenen Nutzer der Liste der Betrachter für Folder hinzu. |
addViewer(user) | Folder | Fügt den angegebenen Nutzer der Liste der Betrachter für Folder hinzu. |
addViewers(emailAddresses) | Folder | Fügt das angegebene Array von Nutzern der Liste der Betrachter für Folder hinzu. |
createFile(blob) | File | Erstellt im aktuellen Ordner eine Datei aus einem gegebenen Blob mit beliebigen Daten. |
createFile(name, content) | File | Erstellt im aktuellen Ordner eine Textdatei mit dem angegebenen Namen und Inhalt. |
createFile(name, content, mimeType) | File | Erstellt im aktuellen Ordner eine Datei 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 zur angegebenen Drive-Element-ID und dem Ressourcenschlüssel und gibt sie zurück. |
getAccess(email) | Permission | Ruft die Berechtigung ab, die dem angegebenen Nutzer gewährt wurde. |
getAccess(user) | Permission | Ruft die Berechtigung ab, die dem angegebenen Nutzer gewährt wurde. |
getDateCreated() | Date | Ruft das Datum ab, an dem Folder erstellt wurde. |
getDescription() | String | Ruft die Beschreibung für Folder ab. |
getEditors() | User[] | Ruft die Liste der Bearbeiter für diesen Folder ab. |
getFiles() | FileIterator | Ruft eine Sammlung aller Dateien ab, die dem aktuellen Ordner untergeordnet 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 dem aktuellen Ordner untergeordnet 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 von Folder ab. |
getLastUpdated() | Date | Ruft das Datum ab, an dem Folder zuletzt aktualisiert wurde. |
getName() | String | Ruft den Namen des Folder ab. |
getOwner() | User | Ruft den Eigentümer von Folder ab. |
getParents() | FolderIterator | Ruft eine Sammlung von Ordnern ab, die Folder unmittelbar übergeordnet sind. |
getResourceKey() | String | Ruft den Ressourcenschlüssel von Folder ab, der für den Zugriff auf Elemente erforderlich ist, die über einen Link freigegeben wurden. |
getSecurityUpdateEligible() | Boolean | 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. |
getSecurityUpdateEnabled() | Boolean | Ruft ab, ob für diesen Folder ein Ressourcenschlüssel für den Zugriff erforderlich ist, wenn er über einen Link freigegeben wird. |
getSharingAccess() | Access | Ruft ab, welche Klasse von Nutzern auf Folder zugreifen kann, ausgenommen einzelne Nutzer, denen explizit Zugriff gewährt wurde. |
getSharingPermission() | Permission | Ruft die Berechtigung für die Nutzer ab, die auf Folder zugreifen können, ausgenommen einzelne Nutzer, denen explizit Zugriff gewährt wurde. |
getSize() | Integer | Ruft die Anzahl der Byte ab, die zum Speichern von Folder in Drive verwendet werden. |
getUrl() | String | Ruft 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() | Boolean | Bestimmt, ob Nutzer mit Bearbeitungsberechtigungen für Folder Dateien für andere Nutzer freigeben oder die Berechtigungen ändern dürfen. |
isStarred() | Boolean | Ermittelt, ob Folder in der Ablage des Nutzers markiert wurde. |
isTrashed() | Boolean | Legt fest, ob sich das Folder -Element im Papierkorb des Nutzers in der Ablage des Nutzers befindet. |
moveTo(destination) | Folder | Verschiebt dieses Element in den angegebenen Zielordner. |
removeEditor(emailAddress) | Folder | Entfernt den angegebenen Nutzer aus der Liste der Bearbeiter für Folder . |
removeEditor(user) | Folder | Entfernt den angegebenen Nutzer aus der Liste der Bearbeiter für Folder . |
removeViewer(emailAddress) | Folder | Entfernt den angegebenen Nutzer aus der Liste der Betrachter und Kommentatoren für Folder . |
removeViewer(user) | Folder | Entfernt den angegebenen Nutzer aus der Liste der Betrachter und Kommentatoren für Folder . |
revokePermissions(emailAddress) | Folder | Hebt den Zugriff auf die Folder auf, die dem jeweiligen Nutzer gewährt wurden. |
revokePermissions(user) | Folder | Hebt den Zugriff auf die Folder auf, die dem jeweiligen Nutzer gewährt wurden. |
searchFiles(params) | FileIterator | Ruft eine Sammlung aller Dateien ab, die dem aktuellen Ordner untergeordnet sind und den angegebenen Suchkriterien entsprechen. |
searchFolders(params) | FolderIterator | Ruft eine Sammlung aller Ordner ab, die dem aktuellen Ordner untergeordnet sind und den angegebenen Suchkriterien entsprechen. |
setDescription(description) | Folder | Legt die Beschreibung für Folder fest. |
setName(name) | Folder | Legt den Namen von Folder fest. |
setOwner(emailAddress) | Folder | Eigentümer von Folder ändern |
setOwner(user) | Folder | Eigentümer von Folder ändern |
setSecurityUpdateEnabled(enabled) | Folder | Legt fest, ob das Folder für den Zugriff einen Ressourcenschlüssel erfordert, wenn es über einen Link freigegeben wird. |
setShareableByEditors(shareable) | Folder | Legt fest, ob Nutzer mit Bearbeitungsberechtigungen für Folder Dateien für andere Nutzer freigeben oder die Berechtigungen ändern dürfen. |
setSharing(accessType, permissionType) | Folder | 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. |
setStarred(starred) | Folder | Legt fest, ob das Folder in der Ablage des Nutzers markiert ist. |
setTrashed(trashed) | Folder | Legt 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
Name | Typ | Beschreibung |
---|---|---|
emailAddress | String | Die 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
Name | Typ | Beschreibung |
---|---|---|
user | User | Eine 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
Name | Typ | Beschreibung |
---|---|---|
emailAddresses | String[] | 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
Name | Typ | Beschreibung |
---|---|---|
emailAddress | String | Die 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
Name | Typ | Beschreibung |
---|---|---|
user | User | Eine 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
Name | Typ | Beschreibung |
---|---|---|
emailAddresses | String[] | 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
Name | Typ | Beschreibung |
---|---|---|
blob | BlobSource | Die 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
Name | Typ | Beschreibung |
---|---|---|
name | String | Der Name der neuen Datei. |
content | String | Der 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
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. |
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
Name | Typ | Beschreibung |
---|---|---|
name | String | Der 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
Name | Typ | Beschreibung |
---|---|---|
targetId | String | Die 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
Name | Typ | Beschreibung |
---|---|---|
targetId | String | Die ID der Zieldatei oder des Zielordners. |
targetResourceKey | String | Der 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
Name | Typ | Beschreibung |
---|---|---|
email | String | Die 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
Name | Typ | Beschreibung |
---|---|---|
user | User | Darstellung 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()
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
Name | Typ | Beschreibung |
---|---|---|
name | String | Der 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
Name | Typ | Beschreibung |
---|---|---|
mimeType | String | Der 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
Name | Typ | Beschreibung |
---|---|---|
name | String | Der 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()
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()
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
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
Name | Typ | Beschreibung |
---|---|---|
destination | Folder | Der 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
Name | Typ | Beschreibung |
---|---|---|
emailAddress | String | Die 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
Name | Typ | Beschreibung |
---|---|---|
user | User | Eine 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
Name | Typ | Beschreibung |
---|---|---|
emailAddress | String | Die 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
Name | Typ | Beschreibung |
---|---|---|
user | User | Eine 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
Name | Typ | Beschreibung |
---|---|---|
emailAddress | String | Die 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
Name | Typ | Beschreibung |
---|---|---|
user | User | Darstellung 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
Name | Typ | Beschreibung |
---|---|---|
params | String | Die 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
Name | Typ | Beschreibung |
---|---|---|
params | String | Die 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
Name | Typ | Beschreibung |
---|---|---|
description | String | Die 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
Name | Typ | Beschreibung |
---|---|---|
name | String | den 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
Name | Typ | Beschreibung |
---|---|---|
emailAddress | String | die 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
Name | Typ | Beschreibung |
---|---|---|
user | User | eine 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
Name | Typ | Beschreibung |
---|---|---|
enabled | Boolean | Gibt 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
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
Name | Typ | Beschreibung |
---|---|---|
accessType | Access | welche Klasse von Nutzern Zugriff auf Folder haben soll |
permissionType | Permission | die 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 Folder
s ist false
.
Parameter
Name | Typ | Beschreibung |
---|---|---|
starred | Boolean | true , 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 Folder
s ist false
.
Parameter
Name | Typ | Beschreibung |
---|---|---|
trashed | Boolean | true , 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