Ein Ordner in Google Drive. Ordner können über DriveApp
erstellt oder aufgerufen 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 das Folder hinzu. |
addViewer(user) | Folder | Fügt den angegebenen Nutzer der Liste der Betrachter für das Folder hinzu. |
addViewers(emailAddresses) | Folder | Fügt das angegebene Array von Nutzern der Betrachterliste für Folder hinzu. |
createFile(blob) | File | Erstellt im aktuellen Ordner eine Datei aus einer bestimmten 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 | Eine Verknüpfung zur angegebenen Drive-Element-ID und dem Ressourcenschlüssel wird erstellt und zurückgegeben. |
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 die Folder erstellt wurde. |
getDescription() | String | Ruft die Beschreibung für den Folder ab. |
getEditors() | User[] | Ruft die Liste der Bearbeiter für dieses Folder -Element 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 die 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 dem Folder unmittelbar übergeordnet sind. |
getResourceKey() | String | Ruft den Ressourcenschlüssel der Folder ab, die für den Zugriff auf Elemente erforderlich ist, die
wurden über einen Link freigegeben. |
getSecurityUpdateEligible() | Boolean | Ruft ab, ob dieser Folder berechtigt ist, das Sicherheitsupdate anzuwenden, das
erfordert für den Zugriff einen Ressourcenschlüssel, wenn er über einen Link freigegeben wird. |
getSecurityUpdateEnabled() | Boolean | Ruft ab, ob dieser Folder einen Ressourcenschlüssel für den Zugriff benötigt, wenn er
die über einen Link freigegeben wurden. |
getSharingAccess() | Access | Ruft ab, welche Klasse von Nutzern außer auf einzelne Nutzer auf das Folder zugreifen kann
Nutzern, denen explizit Zugriff gewährt wurde. |
getSharingPermission() | Permission | Er erhält die Berechtigung für die Nutzer, die auf Folder zugreifen können,
außer für einzelne Nutzer, denen explizit Zugriff gewährt wurde. |
getSize() | Integer | Ruft die Anzahl von Byte ab, die zum Speichern von Folder in Drive verwendet werden. |
getUrl() | String | Ruft die URL ab, die zum Öffnen von Folder in einer Google-App verwendet werden kann, z. B.
Google Drive oder Google Docs. |
getViewers() | User[] | Ruft die Liste der Betrachter und Kommentatoren für dieses Folder ab. |
isShareableByEditors() | Boolean | Legt fest, ob Nutzer mit Bearbeitungsberechtigungen für Folder folgende Aktionen ausführen dürfen:
für andere Nutzer freigeben
oder die Berechtigungen ändern. |
isStarred() | Boolean | Legt fest, ob das Folder im Drive des Nutzers markiert wurde. |
isTrashed() | Boolean | Legt fest, ob sich das Folder im Papierkorb 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 das Folder . |
removeViewer(user) | Folder | Entfernt den angegebenen Nutzer aus der Liste der Betrachter und Kommentatoren für das Folder . |
revokePermissions(emailAddress) | Folder | Hebt den Zugriff auf die Folder auf, die dem angegebenen Nutzer gewährt wurde. |
revokePermissions(user) | Folder | Hebt den Zugriff auf die Folder auf, die dem angegebenen Nutzer gewährt wurde. |
searchFiles(params) | FileIterator | Ruft eine Sammlung aller Dateien ab, die dem aktuellen Ordner untergeordnet sind und der angegebenen Suche entsprechen Kriterien. |
searchFolders(params) | FolderIterator | Ruft eine Sammlung aller Ordner ab, die dem aktuellen Ordner untergeordnet sind und der angegebenen Suche entsprechen Kriterien. |
setDescription(description) | Folder | Legt die Beschreibung für das Folder fest. |
setName(name) | Folder | Legt den Namen des Folder fest. |
setOwner(emailAddress) | Folder | Ändert den Eigentümer von Folder . |
setOwner(user) | Folder | Ändert den Eigentümer von Folder . |
setSecurityUpdateEnabled(enabled) | Folder | Legt fest, ob Folder einen Ressourcenschlüssel für den Zugriff benötigt, wenn er
die über einen Link freigegeben wurden. |
setShareableByEditors(shareable) | Folder | Legt fest, ob Nutzer mit Bearbeitungsberechtigungen für die Folder Dateien freigeben dürfen
oder die Berechtigungen zu ändern. |
setSharing(accessType, permissionType) | Folder | Legt fest, welche Klasse von Nutzern auf die Folder zugreifen kann und welche Berechtigungen
werden diesen Nutzern gewährt, ebenso wie einzelnen Nutzern, denen explizit Zugriff gewährt wurde. |
setStarred(starred) | Folder | Legt fest, ob das Folder im Drive des Nutzers markiert ist. |
setTrashed(trashed) | Folder | Legt fest, ob sich die Folder im Papierkorb 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
wird der Nutzer mit dieser Methode aus der Betrachterliste hochgestuft.
Parameter
Name | Typ | Beschreibung |
---|---|---|
emailAddress | String | Die E-Mail-Adresse des hinzuzufügenden Nutzers. |
Rückflug
Folder
: Diese Folder
zum Verketten.
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
wird der Nutzer mit dieser Methode aus der Betrachterliste hochgestuft.
Parameter
Name | Typ | Beschreibung |
---|---|---|
user | User | Darstellung des hinzuzufügenden Nutzers. |
Rückflug
Folder
: Diese Folder
zum Verketten.
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 eines der
Nutzer, die bereits auf der Liste der Betrachter stehen, werden sie mit dieser Methode aus der Liste der
Zuschauer*innen.
Parameter
Name | Typ | Beschreibung |
---|---|---|
emailAddresses | String[] | Ein Array mit E-Mail-Adressen der Nutzer, die hinzugefügt werden sollen. |
Rückflug
Folder
: Diese Folder
zum Verketten.
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 das Folder
hinzu. Wenn der Nutzer
auf der Liste der Bearbeiter enthält, hat diese Methode keine Auswirkungen.
Parameter
Name | Typ | Beschreibung |
---|---|---|
emailAddress | String | Die E-Mail-Adresse des hinzuzufügenden Nutzers. |
Rückflug
Folder
: Diese Folder
zum Verketten.
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 das Folder
hinzu. Wenn der Nutzer
auf der Liste der Bearbeiter enthält, hat diese Methode keine Auswirkungen.
Parameter
Name | Typ | Beschreibung |
---|---|---|
user | User | Darstellung des hinzuzufügenden Nutzers. |
Rückflug
Folder
: Diese Folder
zum Verketten.
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 Betrachterliste für Folder
hinzu. Wenn eines der
Benutzer, die bereits auf der Liste der Bearbeiter waren, hat diese Methode keine Auswirkungen auf sie.
Parameter
Name | Typ | Beschreibung |
---|---|---|
emailAddresses | String[] | Ein Array mit E-Mail-Adressen der Nutzer, die hinzugefügt werden sollen. |
Rückflug
Folder
: Diese Folder
zum Verketten.
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 einer bestimmten 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. |
Rückflug
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. Wirf einen
Ausnahme, 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
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. Wurfspiele
Ausnahme, 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
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. |
Rückflug
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. |
Rückflug
File
: Die neue Tastenkombination.
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)
Eine Verknüpfung zur angegebenen Drive-Element-ID und dem Ressourcenschlüssel wird erstellt und zurückgegeben. Eine Ressource Schlüssel ist ein zusätzlicher Parameter, der übergeben werden muss, um auf die Zieldatei oder den Zielordner zuzugreifen, die bzw. den wurde per Link freigegeben.
// 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 Tastenkombination.
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 |
Rückflug
Permission
– die Berechtigungen, die dem Nutzer gewährt wurden
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 geprüft werden sollen |
Rückflug
Permission
– die Berechtigungen, die dem Nutzer gewährt wurden
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 die Folder
erstellt wurde.
Rückflug
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 den Folder
ab.
Rückflug
String
: Die Beschreibung für das Folder
-Element
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 dieses Folder
-Element ab. Wenn der Nutzer,
der das Skript ausführt,
keinen Bearbeitungszugriff auf das 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()); }
Rückflug
User[]
: Liste der Bearbeiter für Folder
, wenn der Nutzer Bearbeitungszugriff oder eine
Andernfalls ist ein leeres Array vorhanden.
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.
Rückflug
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. |
Rückflug
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. |
Rückflug
FileIterator
: Eine Sammlung aller Dateien, die dem aktuellen Ordner untergeordnet sind und das angegebene MIME haben
Typ.
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.
Rückflug
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 des zu suchenden Ordners. |
Rückflug
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 die Folder
zuletzt aktualisiert wurde.
Rückflug
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());
Rückflug
User
– Der Eigentümer 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 dem Folder
unmittelbar übergeordnet sind.
Rückflug
FolderIterator
: Eine Sammlung von Ordnern, die unmittelbar übergeordnete Elemente von Folder
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 der Folder
ab, die für den Zugriff auf Elemente erforderlich ist, die
wurden über einen Link freigegeben.
Rückflug
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
erfordert für den Zugriff einen Ressourcenschlüssel, wenn er über einen Link freigegeben wird.
Drive benötigt einen Ressourcenschlüssel, um auf einige Dateien oder Ordner zugreifen zu können, die über ein
. Diese Änderung ist Teil eines Sicherheitsupdates. Das Update ist standardmäßig für berechtigte
Dateien und Ordner. Um die Anforderung von Ressourcenschlüsseln für zulässige Dateien zu aktivieren oder zu deaktivieren, verwenden Sie
setSecurityUpdateEnabled
Weitere Informationen zum Sicherheitsupdate für Google Drive
Rückflug
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 dieser Folder
einen Ressourcenschlüssel für den Zugriff benötigt, wenn er
die über einen Link freigegeben wurden. Diese Anforderung ist für geeignete Dateien und Ordner standardmäßig aktiviert.
Verwenden Sie
setSecurityUpdateEnabled
, um die Anforderung von Ressourcenschlüsseln für zulässige Dateien zu aktivieren oder zu deaktivieren.
Weitere Informationen zum Sicherheitsupdate für Google Drive
Rückflug
Boolean
: Gibt an, ob die Anforderung an den Ressourcenschlüssel 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 außer auf einzelne Nutzer auf das Folder
zugreifen kann
Nutzern, denen explizit Zugriff gewährt wurde.
Rückflug
Access
– welche Klasse von Nutzern kann auf die Folder
zugreifen
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()
Er erhält die Berechtigung für die Nutzer, die auf Folder
zugreifen können,
außer für einzelne Nutzer, denen explizit Zugriff gewährt wurde.
Rückflug
Permission
: die Berechtigungen, die Nutzern gewährt wurden, die auf die 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 von Byte ab, die zum Speichern von Folder
in Drive verwendet werden. Beachten Sie, dass
Dateien aus Google Workspace-Anwendungen werden nicht auf das Drive-Speicherkontingent angerechnet und deshalb zurückgegeben
0
Byte.
Rückflug
Integer
: Die Anzahl der Byte, die zum Speichern von Folder
in Drive verwendet werden
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, die zum Öffnen von Folder
in einer Google-App verwendet werden kann, z. B.
Google Drive oder Google Docs.
Rückflug
String
: Die URL, die verwendet werden kann, um dieses Folder
in einer Google-App wie z. B.
Google Drive oder Google Docs
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()
Ruft die Liste der Betrachter und Kommentatoren für dieses Folder
ab. Wenn Nutzende, die
führt das Skript aus, das keinen Bearbeitungszugriff auf den Folder
hat, mit dieser Methode
gibt 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()); }
Rückflug
User[]
: Liste der Betrachter und Kommentatoren für Folder
, falls der Nutzer eine Änderung vorgenommen hat
oder 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
isStarred()
Legt fest, ob das Folder
im Drive des Nutzers markiert wurde.
Rückflug
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
im Papierkorb der Ablage des Nutzers befindet.
Rückflug
Boolean
: true
, wenn sich die Folder
im Papierkorb der Ablage des Nutzers befindet
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
moveTo(destination)
Verschiebt dieses Element in den angegebenen Zielordner.
Der aktuelle Nutzer muss Eigentümer der Datei sein oder mindestens Bearbeitungszugriff auf das Element aktuellen übergeordneten Ordner, um das Element in den Zielordner zu verschieben.
Parameter
Name | Typ | Beschreibung |
---|---|---|
destination | Folder | Der Ordner, der zum neuen übergeordneten Ordner wird. |
Rückflug
Folder
: Diese Folder
zum Verketten.
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
. Bei dieser Methode werden keine
Nutzer am Zugriff auf Folder
blockieren, wenn sie zu einer Nutzerklasse gehören, die
allgemeinen Zugriff haben, z. B. wenn die Folder
für das gesamte
Domain oder die Folder
befindet sich in einer geteilten Ablage, auf die der Nutzer zugreifen kann.
Bei Drive-Dateien wird der Nutzer dadurch auch aus der Betrachterliste entfernt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
emailAddress | String | Die E-Mail-Adresse des zu entfernenden Nutzers. |
Rückflug
Folder
: Diese Folder
zum Verketten.
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
. Bei dieser Methode werden keine
Nutzer am Zugriff auf Folder
blockieren, wenn sie zu einer Nutzerklasse gehören, die
allgemeinen Zugriff haben, z. B. wenn die Folder
für das gesamte
Domain oder die Folder
befindet sich in einer geteilten Ablage, auf die der Nutzer zugreifen kann.
Bei Drive-Dateien wird der Nutzer dadurch auch aus der Betrachterliste entfernt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
user | User | Eine Darstellung des zu entfernenden Nutzers. |
Rückflug
Folder
: Diese Folder
zum Verketten.
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 das Folder
. Dieses
hat keine Auswirkungen, wenn der Nutzer ein Bearbeiter, kein Betrachter oder Kommentator ist. Bei dieser Methode
Der Zugriff auf Folder
wird nicht blockiert, wenn sie zu einer Klasse von Nutzern gehören, die
allgemeinen Zugriff haben, z. B. wenn die Folder
für das
oder wenn 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 Bearbeiter entfernt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
emailAddress | String | Die E-Mail-Adresse des zu entfernenden Nutzers. |
Rückflug
Folder
: Diese Folder
für die Verkettung.
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 das Folder
. Dieses
hat keine Auswirkungen, wenn der Nutzer ein Bearbeiter und kein Betrachter ist. Diese Methode blockiert auch nicht
Nutzer, die nicht auf die Folder
zugreifen, wenn sie zu einer Nutzerklasse mit allgemeinen
Zugriff haben, z. B. wenn die Folder
für die gesamte Domain des Nutzers freigegeben ist oder
Folder
befindet sich in einer geteilten Ablage, auf die der Nutzer zugreifen kann.
Bei Drive-Dateien wird der Nutzer dadurch auch aus der Liste der Bearbeiter entfernt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
user | User | Eine Darstellung des zu entfernenden Nutzers. |
Rückflug
Folder
: Diese Folder
für die Verkettung.
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 angegebenen Nutzer gewährt wurde. Bei dieser Methode werden keine
Nutzer daran hindern, auf die Folder
zuzugreifen, wenn sie zu einer Klasse von Nutzern gehören, die
allgemeinen Zugriff haben, z. B. wenn die Folder
für das
der gesamten Domain.
Parameter
Name | Typ | Beschreibung |
---|---|---|
emailAddress | String | Die E-Mail-Adresse des Nutzers, dessen Zugriff widerrufen werden soll |
Rückflug
Folder
: Diese Folder
zum Verketten.
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 angegebenen Nutzer gewährt wurde. Bei dieser Methode werden keine
Nutzer daran hindern, auf die Folder
zuzugreifen, wenn sie zu einer Klasse von Nutzern gehören, die
allgemeinen Zugriff haben, z. B. wenn die Folder
für das
der gesamten Domain.
Parameter
Name | Typ | Beschreibung |
---|---|---|
user | User | Darstellung des Nutzers, dessen Zugriff widerrufen werden soll |
Rückflug
Folder
: Diese Folder
zum Verketten.
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 der angegebenen Suche entsprechen Kriterien. Die Suchkriterien sind in der Google Drive SDK-Dokumentation ausführlich beschrieben. Beachten Sie, dass die Drive-Datei Der Dienst verwendet Version 2 der Drive API. Einige Abfragefelder unterscheiden sich von Version 3. Überprüfen Sie das Feld Unterschiede zwischen v2 und v3.
Das Argument params
ist ein Abfragestring, der Stringwerte enthalten kann.
um Anführungszeichen korrekt mit Escapezeichen zu versehen (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. |
Rückflug
FileIterator
: Eine Sammlung aller Dateien, die dem aktuellen Ordner untergeordnet sind und mit der Suche übereinstimmen
Kriterien.
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 der angegebenen Suche entsprechen Kriterien. Die Suchkriterien sind in der Google Drive SDK-Dokumentation ausführlich beschrieben. Beachten Sie, dass die Drive-Datei Der Dienst verwendet Version 2 der Drive API. Einige Abfragefelder unterscheiden sich von Version 3. Überprüfen Sie das Feld Unterschiede zwischen v2 und v3.
Das Argument params
ist ein Abfragestring, der Stringwerte enthalten kann.
um Anführungszeichen korrekt mit Escapezeichen zu versehen (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. |
Rückflug
FolderIterator
: Eine Sammlung aller Ordner, die dem aktuellen Ordner untergeordnet sind und mit der Suche übereinstimmen
Kriterien.
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 das Folder
fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
description | String | die neue Beschreibung für das Folder |
Rückflug
Folder
– diese 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 des Folder
fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
name | String | den neuen Namen von Folder |
Rückflug
Folder
– diese 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)
Ändert den Eigentümer von Folder
. Bei dieser Methode erhält der vorherige Eigentümer
ausdrücklicher Bearbeitungszugriff auf die Folder
.
Parameter
Name | Typ | Beschreibung |
---|---|---|
emailAddress | String | die E-Mail-Adresse des Nutzers, der der neue Eigentümer werden soll |
Rückflug
Folder
– diese 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)
Ändert den Eigentümer von Folder
. Bei dieser Methode erhält der vorherige Eigentümer
ausdrücklicher Bearbeitungszugriff auf die Folder
.
Parameter
Name | Typ | Beschreibung |
---|---|---|
user | User | Darstellung des Nutzers, der der neue Inhaber werden soll |
Rückflug
Folder
– diese 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 Folder
einen Ressourcenschlüssel für den Zugriff benötigt, wenn er
die über einen Link freigegeben wurden. 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. |
Rückflug
Folder
: Diese Folder
zum Verketten.
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 die Folder
zugreifen kann und welche Berechtigungen
werden diesen Nutzern gewährt, ebenso wie 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 Nutzerklasse auf die Folder zugreifen können soll |
permissionType | Permission | die Berechtigungen, die Nutzern gewährt werden sollen, die auf Folder zugreifen können |
Rückflug
Folder
– diese 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
im Drive des Nutzers markiert ist. Der Standardwert für
Der neue Wert für Folder
ist false
.
Parameter
Name | Typ | Beschreibung |
---|---|---|
starred | Boolean | true , wenn Folder im Feld des Nutzers markiert werden soll
Drive: false wenn nicht |
Rückflug
Folder
– diese 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 die Folder
im Papierkorb der Ablage des Nutzers befindet. Nur die
Der Eigentümer kann Folder
in den Papierkorb verschieben. Der Standardwert für neue Folder
ist false
.
Parameter
Name | Typ | Beschreibung |
---|---|---|
trashed | Boolean | true , wenn die Folder in den Papierkorb verschoben werden soll:
in das Google Drive-Konto des Nutzers, false wenn nicht |
Rückflug
Folder
– diese 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