Mit diesem Dienst können Skripts Dateien und Ordner in Google Drive
Wenn im Skript ein Cloud-Standardprojekt statt eines Cloud-Standardprojekts, die Drive API manuell aktivieren. Aktivieren Sie in Ihrem Cloud-Standardprojekt die Drive API:
<ph type="x-smartling-placeholder"></ph> Drive API aktivieren
Das folgende Codebeispiel zeigt, wie die Namen jeder Datei im Ordner „Meine Ablage“:// Logs the name of every file in the user's Drive.
var files = DriveApp.getFiles();
while (files.hasNext()) {
var file = files.next();
console.log(file.getName());
}
<ph type="x-smartling-placeholder">Klassen
Name | Kurzbeschreibung |
---|---|
Access | Ein Enum-Wert, der Klassen von Nutzern darstellt, die auf eine Datei oder einen Ordner zugreifen können, neben einzelnen Nutzern, denen explizit Zugriff gewährt wurde. |
DriveApp | Mit dieser Einstellung können Skripts Dateien und Ordner in Google Drive erstellen, suchen und ändern. |
File | Eine Datei in Google Drive |
FileIterator | Ein Iterator, der es Skripts ermöglicht, eine potenziell große Sammlung von Dateien zu iterieren. |
Folder | Ein Ordner in Google Drive. |
FolderIterator | Ein Objekt, mit dem Skripts eine potenziell große Ordnersammlung durchlaufen können. |
Permission | Ein Enum-Wert, der die Berechtigungen darstellt, die Nutzern gewährt wurden, die auf eine Datei oder einen Ordner zugreifen können, neben Alle einzelnen Nutzer, denen explizit Zugriff gewährt wurde. |
User | Ein Nutzer, der mit einer Datei in Google Drive verknüpft ist. |
Access
Attribute
Attribut | Typ | Beschreibung |
---|---|---|
ANYONE | Enum | Jeder im Internet ist zur Suche und zum Zugriff berechtigt. |
ANYONE_WITH_LINK | Enum | Jeder, der über den Link verfügt, ist zum Zugriff berechtigt. |
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, neben einzelnen Nutzern, denen explizit Zugriff gewährt wurde. |
Permission | Permission | Ein Enum-Wert, der die Berechtigungen darstellt, die Nutzern gewährt wurden, die auf eine Datei oder einen Ordner zugreifen können, neben Alle einzelnen Nutzer, denen explizit Zugriff gewährt wurde. |
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
continueFileIterator(continuationToken) | FileIterator | Setzt eine Dateiiteration mit einem Fortsetzungstoken aus einem vorherigen Iterator fort. |
continueFolderIterator(continuationToken) | FolderIterator | Setzt eine Ordneriteration mit einem Fortsetzungstoken aus einem vorherigen Iterator fort. |
createFile(blob) | File | Erstellt im Stammverzeichnis des Drive-Kontos des Nutzers eine Datei aus einer bestimmten Blob mit beliebigen Daten. |
createFile(name, content) | File | Erstellt im Stammverzeichnis des Nutzers in Google Drive eine Textdatei mit dem angegebenen Namen und Inhalt. |
createFile(name, content, mimeType) | File | Erstellt im Stammverzeichnis des Nutzers in Google Drive eine Datei mit dem angegebenen Namen, Inhalt und MIME-Typ. |
createFolder(name) | Folder | Es wird ein Ordner mit dem angegebenen Namen im Stammverzeichnis des Drive-Kontos des Nutzers erstellt. |
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. |
enforceSingleParent(value) | void | Aktiviert oder deaktiviert dasforceSingleParent-Verhalten 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 Ressourcenschlüssel ab. |
getFiles() | FileIterator | Ruft eine Sammlung aller Dateien im Google Drive des Nutzers ab. |
getFilesByName(name) | FileIterator | Ruft eine Sammlung aller Dateien im Drive des Nutzers ab, die den angegebenen Namen haben. |
getFilesByType(mimeType) | FileIterator | Ruft eine Sammlung aller Dateien im Drive des Nutzers ab, die den angegebenen MIME-Typ haben. |
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 im Google Drive des Nutzers ab. |
getFoldersByName(name) | FolderIterator | Ruft eine Sammlung aller Ordner in der Ablage des Nutzers ab, die den angegebenen Namen haben. |
getRootFolder() | Folder | Es wird der Ordner im Stammverzeichnis des Drive-Kontos des Nutzers abgerufen. |
getStorageLimit() | Integer | Ruft die Anzahl der Bytes ab, die der Nutzer in Drive speichern darf. |
getStorageUsed() | Integer | Ruft die Anzahl der Bytes ab, die der Nutzer derzeit in Drive speichert. |
getTrashedFiles() | FileIterator | Ruft eine Sammlung aller Dateien im Papierkorb des Google Drive des Nutzers ab. |
getTrashedFolders() | FolderIterator | Ruft eine Sammlung aller Ordner im Papierkorb des Google Drive des Nutzers ab. |
searchFiles(params) | FileIterator | Ruft eine Sammlung aller Dateien im Drive des Nutzers ab, die der angegebenen Suche entsprechen Kriterien. |
searchFolders(params) | FolderIterator | Ruft eine Sammlung aller Ordner im Google Drive des Nutzers ab, die der angegebenen Suche entsprechen Kriterien. |
File
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
addCommenter(emailAddress) | File | Fügen Sie den angegebenen Nutzer der Liste der Kommentatoren für das File hinzu. |
addCommenter(user) | File | Fügen Sie den angegebenen Nutzer der Liste der Kommentatoren für das 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 das File hinzu. |
addViewer(user) | File | Fügt den angegebenen Nutzer der Liste der Betrachter für das File hinzu. |
addViewers(emailAddresses) | File | Fügt das angegebene Array von Nutzern der Betrachterliste für File hinzu. |
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. |
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 die File erstellt wurde. |
getDescription() | String | Ruft die Beschreibung für den 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 -Element ab. |
getId() | String | Ruft die ID von File ab. |
getLastUpdated() | Date | Ruft das Datum ab, an dem die File zuletzt aktualisiert wurde. |
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 dem File unmittelbar übergeordnet sind. |
getResourceKey() | String | Ruft den Ressourcenschlüssel der File ab, die für den Zugriff auf Elemente erforderlich ist, die
wurden über einen Link freigegeben. |
getSecurityUpdateEligible() | Boolean | Ruft ab, ob dieser File 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 File 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 File zugreifen kann
Nutzern, denen explizit Zugriff gewährt wurde. |
getSharingPermission() | Permission | Er erhält die Berechtigung für die Nutzer, die auf File 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 File in Drive verwendet werden. |
getTargetId() | String | Bei einem Shortcut wird die ID des Elements zurückgegeben, auf das es verweist. |
getTargetMimeType() | String | Bei einem Shortcut wird der MIME-Typ des Elements zurückgegeben, auf das es verweist. |
getTargetResourceKey() | String | Wenn es sich bei der Datei um eine Verknüpfung handelt, wird der Ressourcenschlüssel des Elements zurückgegeben, auf das sie verweist. |
getThumbnail() | Blob | Ruft eine Miniaturansicht für die Datei ab oder null , wenn keine Miniaturansicht vorhanden ist. |
getUrl() | String | Ruft die URL ab, die zum Öffnen von File 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 File ab. |
isShareableByEditors() | Boolean | Legt fest, ob Nutzer mit Bearbeitungsberechtigungen für File folgende Aktionen ausführen dürfen:
für andere Nutzer freigeben
oder die Berechtigungen ändern. |
isStarred() | Boolean | Legt fest, ob das File im Drive des Nutzers markiert wurde. |
isTrashed() | Boolean | Legt fest, ob sich das File im Papierkorb der Ablage 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 gibt ihr den angegebenen Namen. |
makeCopy(name, destination) | File | Erstellt eine Kopie der Datei im Zielverzeichnis und gibt ihr den angegebenen Namen. |
moveTo(destination) | File | Verschiebt dieses Element in den angegebenen Zielordner. |
removeCommenter(emailAddress) | File | Entfernt den angegebenen Nutzer aus der Liste der Kommentatoren für das File . |
removeCommenter(user) | File | Entfernt den angegebenen Nutzer aus der Liste der Kommentatoren für das File . |
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 | Entfernt den angegebenen Nutzer aus der Liste der Betrachter und Kommentatoren für das File . |
removeViewer(user) | File | Entfernt den angegebenen Nutzer aus der Liste der Betrachter und Kommentatoren für das File . |
revokePermissions(emailAddress) | File | Hebt den Zugriff auf die File auf, die dem angegebenen Nutzer gewährt wurde. |
revokePermissions(user) | File | Hebt den Zugriff auf die File auf, die dem angegebenen Nutzer gewährt wurde. |
setContent(content) | File | Überschreibt den Inhalt der Datei mit einem bestimmten Ersatz. |
setDescription(description) | File | Legt die Beschreibung für das File fest. |
setName(name) | File | Legt den Namen des File fest. |
setOwner(emailAddress) | File | Ändert den Eigentümer von File . |
setOwner(user) | File | Ändert den Eigentümer von File . |
setSecurityUpdateEnabled(enabled) | File | Legt fest, ob File einen Ressourcenschlüssel für den Zugriff benötigt, wenn er
die über einen Link freigegeben wurden. |
setShareableByEditors(shareable) | File | Legt fest, ob Nutzer mit Bearbeitungsberechtigungen für die File Dateien freigeben dürfen
oder die Berechtigungen zu ändern. |
setSharing(accessType, permissionType) | File | Legt fest, welche Klasse von Nutzern auf die File zugreifen kann und welche Berechtigungen
werden diesen Nutzern gewährt, ebenso wie einzelnen Nutzern, denen explizit Zugriff gewährt wurde. |
setStarred(starred) | File | Legt fest, ob das File im Drive des Nutzers markiert ist. |
setTrashed(trashed) | File | Legt fest, ob sich die File im Papierkorb der Ablage des Nutzers befindet. |
FileIterator
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
getContinuationToken() | String | Ruft ein Token ab, mit dem diese Iteration zu einem späteren Zeitpunkt 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 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. |
FolderIterator
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
getContinuationToken() | String | Ruft ein Token ab, mit dem diese Iteration zu einem späteren Zeitpunkt 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 mit Zugriff auf die Datei oder den Ordner können die Datei oder den Ordner nur ansehen oder kopieren. |
EDIT | Enum | Nutzer, die Zugriff auf die Datei oder den Ordner haben, können die Datei oder den Ordner bearbeiten. |
COMMENT | Enum | Nutzer mit Zugriff auf die Datei oder den Ordner können die Datei oder den Ordner 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 dürfen. |
NONE | Enum | Der Nutzer hat keine Berechtigungen für die Datei oder den Ordner. |
User
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
getDomain() | String | Ruft den Domainnamen ab, der dem Konto des Nutzers zugeordnet ist. |
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 Nutzerfoto ab. |