Mit diesem Dienst können Skripts Dateien und Ordner in Google Drive erstellen, suchen und ändern.
// Log the name of every file in the user's Drive.
var files = DriveApp.getFiles();
while (files.hasNext()) {
var file = files.next();
Logger.log(file.getName());
}
Kurse
Name | Kurzbeschreibung |
---|---|
Access | Ein Enum-Wert, der Klassen von Nutzern darstellt, die auf eine Datei oder einen Ordner zugreifen können, zusätzlich zu einzelnen Nutzern, denen explizit Zugriff gewährt wurde. |
DriveApp | Ermöglicht es Skripts, Dateien und Ordner in Google Drive zu erstellen, zu suchen und zu ändern. |
File | Eine Datei in Google Drive. |
FileIterator | Ein Iterator, der es Skripts ermöglicht, über eine möglicherweise große Sammlung von Dateien zu iterieren |
Folder | Ein Ordner in Google Drive. |
FolderIterator | Ein Objekt, mit dem Skripts eine potenziell große Sammlung von Ordnern durchlaufen können. |
Permission | Ein Enum-Wert, der die Berechtigungen für Nutzer darstellt, die auf eine Datei oder einen Ordner zugreifen können, sowie auf einzelne Nutzer, denen explizit Zugriff gewährt wurde. |
User | Ein Nutzer, der einer Datei in Google Drive zugeordnet ist. |
Access
Attribute
Attribut | Typ | Beschreibung |
---|---|---|
ANYONE | Enum | Jeder im Internet kann die Elemente finden und darauf zugreifen. |
ANYONE_WITH_LINK | Enum | Jeder, der über den Link verfügt, hat Zugriff. |
DOMAIN | Enum | Personen in Ihrer Domain sind zur Suche und zum Zugriff berechtigt. |
DOMAIN_WITH_LINK | Enum | Personen in Ihrer Domain, die über den Link verfügen, sind zum Zugriff berechtigt. |
PRIVATE | Enum | Nur Personen, denen die entsprechende Berechtigung ausdrücklich erteilt wurde, sind zum Zugriff befugt. |
DriveApp
Attribute
Attribut | Typ | Beschreibung |
---|---|---|
Access | Access | Ein Enum-Wert, der Klassen von Nutzern darstellt, die auf eine Datei oder einen Ordner zugreifen können, zusätzlich zu einzelnen Nutzern, denen explizit Zugriff gewährt wurde. |
Permission | Permission | Ein Enum-Wert, der die Berechtigungen für Nutzer darstellt, die auf eine Datei oder einen Ordner zugreifen können, sowie auf einzelne Nutzer, denen explizit Zugriff gewährt wurde. |
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
continueFileIterator(continuationToken) | FileIterator | Setzt eine Datei Iteration mit einem Fortsetzungs-Token aus einem vorherigen Iterator fort. |
continueFolderIterator(continuationToken) | FolderIterator | Setzt eine Ordneriteration mit einem Fortsetzungstoken aus einem vorherigen Iterator fort. |
createFile(blob) | File | Erstellt eine Datei im Stammverzeichnis der Ablage des Nutzers aus einer angegebenen Blob mit beliebigen Daten. |
createFile(name, content) | File | Erstellt eine Textdatei im Stammverzeichnis des Nutzers mit dem angegebenen Namen und Inhalt. |
createFile(name, content, mimeType) | File | Erstellt im Stammverzeichnis des Nutzers eine Datei mit dem angegebenen Namen, Inhalt und MIME-Typ. |
createFolder(name) | Folder | Ein Ordner im Stammverzeichnis der Ablage in Google Drive mit dem angegebenen Namen wird erstellt. |
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 zum angegebenen Ressourcenschlüssel und gibt sie zurück |
enforceSingleParent(value) | void | Aktiviert oder deaktiviert das Erzwingen von „SingleSingleParent“ für alle Aufrufe, die sich auf übergeordnete Elemente auswirken. |
getFileById(id) | File | Ruft die Datei mit der angegebenen ID ab. |
getFileByIdAndResourceKey(id, resourceKey) | File | Ruft die Datei mit der angegebenen ID und dem angegebenen Ressourcenschlüssel ab. |
getFiles() | FileIterator | Ruft eine Sammlung aller Dateien in der Ablage des Nutzers ab. |
getFilesByName(name) | FileIterator | Ruft eine Sammlung aller Dateien in Google Drive mit dem angegebenen Namen ab. |
getFilesByType(mimeType) | FileIterator | Ruft eine Sammlung aller Dateien in der Drive-Ablage des Nutzers ab, die den angegebenen MIME-Typ aufweisen. |
getFolderById(id) | Folder | Ruft den Ordner mit der angegebenen ID ab. |
getFolderByIdAndResourceKey(id, resourceKey) | Folder | Ruft den Ordner mit der angegebenen ID und dem angegebenen Ressourcenschlüssel ab. |
getFolders() | FolderIterator | Ruft eine Sammlung aller Ordner in der Ablage des Nutzers ab. |
getFoldersByName(name) | FolderIterator | Ruft eine Sammlung aller Ordner in Google Drive mit dem angegebenen Namen ab. |
getRootFolder() | Folder | Ruft den Ordner im Stammverzeichnis des Nutzers in Google Drive ab. |
getStorageLimit() | Integer | Ruft die Anzahl der Byte ab, die der Nutzer in Google Drive speichern darf. |
getStorageUsed() | Integer | Ruft die Anzahl der Byte ab, die der Nutzer derzeit in Google Drive speichert. |
getTrashedFiles() | FileIterator | Ruft eine Sammlung aller Dateien im Papierkorb des Nutzers in Google Drive ab. |
getTrashedFolders() | FolderIterator | Ruft eine Sammlung aller Ordner im Papierkorb des Nutzers in Google Drive ab. |
searchFiles(params) | FileIterator | Ruft eine Sammlung aller Dateien im Drive-Konto des Nutzers ab, die den angegebenen Suchkriterien entsprechen. |
searchFolders(params) | FolderIterator | Ruft eine Sammlung aller Ordner im Drive des Nutzers ab, die den angegebenen Suchkriterien entsprechen. |
File
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
addCommenter(emailAddress) | File | Fügt den angegebenen Nutzer der Liste der Kommentatoren für File hinzu. |
addCommenter(user) | File | Fügt den angegebenen Nutzer der Liste der Kommentatoren für File hinzu. |
addCommenters(emailAddresses) | File | Fügt das angegebene Array von Nutzern der Liste der Kommentatoren für File hinzu. |
addEditor(emailAddress) | File | Fügt den angegebenen Nutzer der Liste der Bearbeiter für File hinzu. |
addEditor(user) | File | Fügt den angegebenen Nutzer der Liste der Bearbeiter für File hinzu. |
addEditors(emailAddresses) | File | Fügt das angegebene Array von Nutzern der Liste der Bearbeiter für File hinzu. |
addViewer(emailAddress) | File | Fügt den angegebenen Nutzer der Liste der Betrachter für File hinzu. |
addViewer(user) | File | Fügt den angegebenen Nutzer der Liste der Betrachter für File hinzu. |
addViewers(emailAddresses) | File | Fügt das angegebene Array von Nutzern zur Liste der Betrachter für File hinzu. |
getAccess(email) | Permission | Ruft die dem angegebenen Nutzer gewährte Berechtigung ab. |
getAccess(user) | Permission | Ruft die dem angegebenen Nutzer gewährte Berechtigung ab. |
getAs(contentType) | Blob | Gibt die Daten in diesem Objekt als Blob zurück, das in den angegebenen Inhaltstyp konvertiert wurde. |
getBlob() | Blob | Gibt die Daten in diesem Objekt als Blob zurück. |
getDateCreated() | Date | Ruft das Datum ab, an dem File erstellt wurde. |
getDescription() | String | Ruft die Beschreibung für File ab. |
getDownloadUrl() | String | Ruft die URL ab, die zum Herunterladen der Datei verwendet werden kann. |
getEditors() | User[] | Ruft die Liste der Bearbeiter für dieses File ab. |
getId() | String | Ruft die ID von File ab. |
getLastUpdated() | Date | Ruft das Datum der letzten Aktualisierung von File ab. |
getMimeType() | String | Ruft den MIME-Typ der Datei ab. |
getName() | String | Ruft den Namen des File ab. |
getOwner() | User | Ruft den Dateieigentümer ab. |
getParents() | FolderIterator | Ruft eine Sammlung von Ordnern ab, die direkte übergeordnete Elemente von File sind. |
getResourceKey() | String | Ruft den Ressourcenschlüssel von File ab, der für den Zugriff auf Elemente erforderlich ist, die über einen Link freigegeben wurden. |
getSecurityUpdateEligible() | Boolean | Ruft ab, ob dieses File das Sicherheitsupdate anwenden kann, für das ein Ressourcenschlüssel für den Zugriff erforderlich ist, wenn er über einen Link freigegeben wird. |
getSecurityUpdateEnabled() | Boolean | Ruft ab, ob dieser File einen Ressourcenschlüssel für den Zugriff benötigt, wenn er über einen Link freigegeben wird. |
getSharingAccess() | Access | Ruft ab, welche Nutzerklasse auf die File zugreifen kann, abgesehen von den einzelnen Nutzern, denen explizit Zugriff gewährt wurde. |
getSharingPermission() | Permission | Ruft die Berechtigung ab, die diesen Nutzern gewährt wird, die auf File zugreifen können, abgesehen von den einzelnen Nutzern, denen explizit Zugriff gewährt wurde. |
getSize() | Integer | Ruft die Anzahl der Byte ab, die zum Speichern von File in Google Drive verwendet werden. |
getTargetId() | String | Wenn es sich um eine Verknüpfung handelt, wird die ID des Elements zurückgegeben, auf das es verweist. |
getTargetMimeType() | String | Wenn dies eine Verknüpfung ist, wird der MIME-Typ des Elements zurückgegeben, auf das es verweist. |
getTargetResourceKey() | String | Wenn die Datei eine Verknüpfung ist, wird der Ressourcenschlüssel des Elements zurückgegeben, auf das es verweist. |
getThumbnail() | Blob | Ruft eine Miniaturansicht für die Datei oder null ab, wenn keine Miniaturansicht vorhanden ist. |
getUrl() | String | Ruft die URL ab, mit der File in einer Google-App wie Google Drive oder Google Docs geöffnet werden kann. |
getViewers() | User[] | Ruft die Liste der Betrachter und Kommentatoren für File ab. |
isShareableByEditors() | Boolean | Bestimmt, ob Nutzer mit Bearbeitungsberechtigungen für die File Dateien für andere Nutzer freigeben oder die Berechtigungen ändern dürfen. |
isStarred() | Boolean | Ermittelt, ob File in der Ablage des Nutzers markiert wurde. |
isTrashed() | Boolean | Bestimmt, ob sich die File im Papierkorb des Drive-Kontos des Nutzers befindet. |
makeCopy() | File | Erstellt eine Kopie der Datei. |
makeCopy(destination) | File | Erstellt eine Kopie der Datei im Zielverzeichnis. |
makeCopy(name) | File | Erstellt eine Kopie der Datei und benennt sie mit dem angegebenen Namen. |
makeCopy(name, destination) | File | Erstellt eine Kopie der Datei im Zielverzeichnis und benennt sie mit dem angegebenen Namen. |
moveTo(destination) | File | Verschiebt das Element in den angegebenen Zielordner. |
removeCommenter(emailAddress) | File | Der angegebene Nutzer wird aus der Liste der Kommentatoren für File entfernt. |
removeCommenter(user) | File | Der angegebene Nutzer wird aus der Liste der Kommentatoren für File entfernt. |
removeEditor(emailAddress) | File | Entfernt den angegebenen Nutzer aus der Liste der Bearbeiter für File . |
removeEditor(user) | File | Entfernt den angegebenen Nutzer aus der Liste der Bearbeiter für File . |
removeViewer(emailAddress) | File | Der Nutzer wird aus der Liste der Betrachter und Kommentatoren für File entfernt. |
removeViewer(user) | File | Der Nutzer wird aus der Liste der Betrachter und Kommentatoren für File entfernt. |
revokePermissions(emailAddress) | File | Hebt den Zugriff auf den File auf, der dem Nutzer zugewiesen wurde. |
revokePermissions(user) | File | Hebt den Zugriff auf den File auf, der dem Nutzer zugewiesen wurde. |
setContent(content) | File | Überschreibt den Inhalt der Datei mit einem bestimmten Ersatz. |
setDescription(description) | File | Legt die Beschreibung für File fest. |
setName(name) | File | Legt den Namen von File fest. |
setOwner(emailAddress) | File | Ändert den Inhaber von File . |
setOwner(user) | File | Ändert den Inhaber von File . |
setSecurityUpdateEnabled(enabled) | File | Legt fest, ob File einen Ressourcenschlüssel für den Zugriff benötigt, wenn er über einen Link freigegeben wird. |
setShareableByEditors(shareable) | File | Legt fest, ob Nutzer mit Bearbeitungsberechtigungen für File Dateien für andere Nutzer freigeben oder die Berechtigungen ändern dürfen. |
setSharing(accessType, permissionType) | File | Legt fest, welche Nutzer auf die File zugreifen und welche Berechtigungen ihnen diese Nutzer erteilen können, abgesehen von den einzelnen Nutzern, denen explizit Zugriff gewährt wurde. |
setStarred(starred) | File | Legt fest, ob File in der Ablage des Nutzers markiert ist. |
setTrashed(trashed) | File | Gibt an, ob sich File im Papierkorb der Ablage des Nutzers befindet. |
FileIterator
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
getContinuationToken() | String | Ruft ein Token ab, mit dem diese Iteration später fortgesetzt werden kann. |
hasNext() | Boolean | Legt fest, ob beim Aufrufen von next() ein Element zurückgegeben wird. |
next() | File | Ruft das nächste Element in der Sammlung von Dateien oder Ordnern ab. |
Folder
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 zur Liste der Betrachter für Folder hinzu. |
createFile(blob) | File | Erstellt eine Datei im aktuellen Ordner aus einer angegebenen Blob von 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 zum angegebenen Ressourcenschlüssel und gibt sie zurück |
getAccess(email) | Permission | Ruft die dem angegebenen Nutzer gewährte Berechtigung ab. |
getAccess(user) | Permission | Ruft die dem angegebenen Nutzer gewährte Berechtigung ab. |
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 dieses 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 der letzten Aktualisierung von Folder ab. |
getName() | String | Ruft den Namen des Folder ab. |
getOwner() | User | Ruft den Inhaber von Folder ab. |
getParents() | FolderIterator | Ruft eine Sammlung von Ordnern ab, die direkte übergeordnete Elemente von Folder 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 dieses Folder das Sicherheitsupdate anwenden kann, für das ein Ressourcenschlüssel für den Zugriff erforderlich ist, 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 über einen Link freigegeben wird. |
getSharingAccess() | Access | Ruft ab, welche Nutzerklasse auf die Folder zugreifen kann, abgesehen von den einzelnen Nutzern, denen explizit Zugriff gewährt wurde. |
getSharingPermission() | Permission | Ruft die Berechtigung ab, die diesen Nutzern gewährt wird, die auf Folder zugreifen können, abgesehen von den einzelnen Nutzern, denen explizit Zugriff gewährt wurde. |
getSize() | Integer | Ruft die Anzahl der Byte ab, die zum Speichern von Folder in Google Drive verwendet werden. |
getUrl() | String | Ruft die URL ab, mit der Folder in einer Google-App wie Google Drive oder Google Docs geöffnet werden kann. |
getViewers() | User[] | Ruft die Liste der Betrachter und Kommentatoren für Folder ab. |
isShareableByEditors() | Boolean | Bestimmt, ob Nutzer mit Bearbeitungsberechtigungen für die 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 | Bestimmt, ob sich die Folder im Papierkorb des Drive-Kontos des Nutzers befindet. |
moveTo(destination) | Folder | Verschiebt das 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 | Der Nutzer wird aus der Liste der Betrachter und Kommentatoren für Folder entfernt. |
removeViewer(user) | Folder | Der Nutzer wird aus der Liste der Betrachter und Kommentatoren für Folder entfernt. |
revokePermissions(emailAddress) | Folder | Hebt den Zugriff auf den Folder auf, der dem Nutzer zugewiesen wurde. |
revokePermissions(user) | Folder | Hebt den Zugriff auf den Folder auf, der dem Nutzer zugewiesen wurde. |
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 | Ändert den Inhaber von Folder . |
setOwner(user) | Folder | Ändert den Inhaber von Folder . |
setSecurityUpdateEnabled(enabled) | Folder | Legt fest, ob Folder einen Ressourcenschlüssel für den Zugriff benötigt, wenn er ü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 Nutzer auf die Folder zugreifen und welche Berechtigungen ihnen diese Nutzer erteilen können, abgesehen von den einzelnen Nutzern, denen explizit Zugriff gewährt wurde. |
setStarred(starred) | Folder | Legt fest, ob Folder in der Ablage des Nutzers markiert ist. |
setTrashed(trashed) | Folder | Gibt an, ob sich Folder im Papierkorb der Ablage des Nutzers befindet. |
FolderIterator
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
getContinuationToken() | String | Ruft ein Token ab, mit dem diese Iteration später fortgesetzt werden kann. |
hasNext() | Boolean | Legt fest, ob beim Aufrufen von next() ein Element zurückgegeben wird. |
next() | Folder | Ruft das nächste Element in der Sammlung von Dateien oder Ordnern ab. |
Permission
Attribute
Attribut | Typ | Beschreibung |
---|---|---|
VIEW | Enum | Nutzer, die auf die Datei oder den Ordner zugreifen können, können sie nur ansehen oder kopieren. |
EDIT | Enum | Nutzer, die auf die Datei oder den Ordner zugreifen können, können sie auch bearbeiten. |
COMMENT | Enum | Nutzer, die auf die Datei oder den Ordner zugreifen können, können sie nur ansehen, kopieren oder kommentieren. |
OWNER | Enum | Der Nutzer ist Eigentümer der Datei oder des Ordners. |
ORGANIZER | Enum | Nutzer, die Dateien und Ordner in einer geteilten Ablage organisieren können. |
FILE_ORGANIZER | Enum | Nutzer, die Inhalte in einer geteilten Ablage bearbeiten, in den Papierkorb verschieben und verschieben können |
NONE | Enum | Der Nutzer hat keine Berechtigungen für die Datei oder den Ordner. |
User
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
getDomain() | String | Ruft den mit dem Konto des Nutzers verknüpften Domainnamen ab. |
getEmail() | String | Ruft die E-Mail-Adresse des Nutzers ab. |
getName() | String | Ruft den Namen des Nutzers ab. |
getPhotoUrl() | String | Ruft die URL für das Foto des Nutzers ab. |