Drive Service

Drive

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

NameKurzbeschreibung
AccessEin 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.
DriveAppMit dieser Einstellung können Skripts Dateien und Ordner in Google Drive erstellen, suchen und ändern.
FileEine Datei in Google Drive
FileIteratorEin Iterator, der es Skripts ermöglicht, eine potenziell große Sammlung von Dateien zu iterieren.
FolderEin Ordner in Google Drive.
FolderIteratorEin Objekt, mit dem Skripts eine potenziell große Ordnersammlung durchlaufen können.
PermissionEin 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.
UserEin Nutzer, der mit einer Datei in Google Drive verknüpft ist.

Access

Attribute

AttributTypBeschreibung
ANYONEEnumJeder im Internet ist zur Suche und zum Zugriff berechtigt.
ANYONE_WITH_LINKEnumJeder, der über den Link verfügt, ist zum Zugriff berechtigt.
DOMAINEnumPersonen in Ihrer Domain sind zur Suche und zum Zugriff berechtigt.
DOMAIN_WITH_LINKEnumPersonen in Ihrer Domain, die über den Link verfügen, sind zum Zugriff berechtigt.
PRIVATEEnumNur Personen, denen die entsprechende Berechtigung ausdrücklich erteilt wurde, sind zum Zugriff befugt.

DriveApp

Attribute

AttributTypBeschreibung
AccessAccessEin 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.
PermissionPermissionEin 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

MethodeRückgabetypKurzbeschreibung
continueFileIterator(continuationToken)FileIteratorSetzt eine Dateiiteration mit einem Fortsetzungstoken aus einem vorherigen Iterator fort.
continueFolderIterator(continuationToken)FolderIteratorSetzt eine Ordneriteration mit einem Fortsetzungstoken aus einem vorherigen Iterator fort.
createFile(blob)FileErstellt im Stammverzeichnis des Drive-Kontos des Nutzers eine Datei aus einer bestimmten Blob mit beliebigen Daten.
createFile(name, content)FileErstellt im Stammverzeichnis des Nutzers in Google Drive eine Textdatei mit dem angegebenen Namen und Inhalt.
createFile(name, content, mimeType)FileErstellt im Stammverzeichnis des Nutzers in Google Drive eine Datei mit dem angegebenen Namen, Inhalt und MIME-Typ.
createFolder(name)FolderEs wird ein Ordner mit dem angegebenen Namen im Stammverzeichnis des Drive-Kontos des Nutzers erstellt.
createShortcut(targetId)FileErstellt eine Verknüpfung zur angegebenen Drive-Element-ID und gibt sie zurück.
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)FileEine Verknüpfung zur angegebenen Drive-Element-ID und dem Ressourcenschlüssel wird erstellt und zurückgegeben.
enforceSingleParent(value)voidAktiviert oder deaktiviert dasforceSingleParent-Verhalten für alle Aufrufe, die sich auf übergeordnete Elemente auswirken.
getFileById(id)FileRuft die Datei mit der angegebenen ID ab.
getFileByIdAndResourceKey(id, resourceKey)FileRuft die Datei mit der angegebenen ID und dem Ressourcenschlüssel ab.
getFiles()FileIteratorRuft eine Sammlung aller Dateien im Google Drive des Nutzers ab.
getFilesByName(name)FileIteratorRuft eine Sammlung aller Dateien im Drive des Nutzers ab, die den angegebenen Namen haben.
getFilesByType(mimeType)FileIteratorRuft eine Sammlung aller Dateien im Drive des Nutzers ab, die den angegebenen MIME-Typ haben.
getFolderById(id)FolderRuft den Ordner mit der angegebenen ID ab.
getFolderByIdAndResourceKey(id, resourceKey)FolderRuft den Ordner mit der angegebenen ID und dem angegebenen Ressourcenschlüssel ab.
getFolders()FolderIteratorRuft eine Sammlung aller Ordner im Google Drive des Nutzers ab.
getFoldersByName(name)FolderIteratorRuft eine Sammlung aller Ordner in der Ablage des Nutzers ab, die den angegebenen Namen haben.
getRootFolder()FolderEs wird der Ordner im Stammverzeichnis des Drive-Kontos des Nutzers abgerufen.
getStorageLimit()IntegerRuft die Anzahl der Bytes ab, die der Nutzer in Drive speichern darf.
getStorageUsed()IntegerRuft die Anzahl der Bytes ab, die der Nutzer derzeit in Drive speichert.
getTrashedFiles()FileIteratorRuft eine Sammlung aller Dateien im Papierkorb des Google Drive des Nutzers ab.
getTrashedFolders()FolderIteratorRuft eine Sammlung aller Ordner im Papierkorb des Google Drive des Nutzers ab.
searchFiles(params)FileIteratorRuft eine Sammlung aller Dateien im Drive des Nutzers ab, die der angegebenen Suche entsprechen Kriterien.
searchFolders(params)FolderIteratorRuft eine Sammlung aller Ordner im Google Drive des Nutzers ab, die der angegebenen Suche entsprechen Kriterien.

File

Methoden

MethodeRückgabetypKurzbeschreibung
addCommenter(emailAddress)FileFügen Sie den angegebenen Nutzer der Liste der Kommentatoren für das File hinzu.
addCommenter(user)FileFügen Sie den angegebenen Nutzer der Liste der Kommentatoren für das File hinzu.
addCommenters(emailAddresses)FileFügt das angegebene Array von Nutzern der Liste der Kommentatoren für File hinzu.
addEditor(emailAddress)FileFügt den angegebenen Nutzer der Liste der Bearbeiter für File hinzu.
addEditor(user)FileFügt den angegebenen Nutzer der Liste der Bearbeiter für File hinzu.
addEditors(emailAddresses)FileFügt das angegebene Array von Nutzern der Liste der Bearbeiter für File hinzu.
addViewer(emailAddress)FileFügt den angegebenen Nutzer der Liste der Betrachter für das File hinzu.
addViewer(user)FileFügt den angegebenen Nutzer der Liste der Betrachter für das File hinzu.
addViewers(emailAddresses)FileFügt das angegebene Array von Nutzern der Betrachterliste für File hinzu.
getAccess(email)PermissionRuft die Berechtigung ab, die dem angegebenen Nutzer gewährt wurde.
getAccess(user)PermissionRuft die Berechtigung ab, die dem angegebenen Nutzer gewährt wurde.
getAs(contentType)BlobGibt die Daten in diesem Objekt als Blob zurück, das in den angegebenen Inhaltstyp konvertiert wurde.
getBlob()BlobGibt die Daten in diesem Objekt als Blob zurück.
getDateCreated()DateRuft das Datum ab, an dem die File erstellt wurde.
getDescription()StringRuft die Beschreibung für den File ab.
getDownloadUrl()StringRuft 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()StringRuft die ID von File ab.
getLastUpdated()DateRuft das Datum ab, an dem die File zuletzt aktualisiert wurde.
getMimeType()StringRuft den MIME-Typ der Datei ab.
getName()StringRuft den Namen des File ab.
getOwner()UserRuft den Dateieigentümer ab.
getParents()FolderIteratorRuft eine Sammlung von Ordnern ab, die dem File unmittelbar übergeordnet sind.
getResourceKey()StringRuft den Ressourcenschlüssel der File ab, die für den Zugriff auf Elemente erforderlich ist, die wurden über einen Link freigegeben.
getSecurityUpdateEligible()BooleanRuft 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()BooleanRuft ab, ob dieser File einen Ressourcenschlüssel für den Zugriff benötigt, wenn er die über einen Link freigegeben wurden.
getSharingAccess()AccessRuft ab, welche Klasse von Nutzern außer auf einzelne Nutzer auf das File zugreifen kann Nutzern, denen explizit Zugriff gewährt wurde.
getSharingPermission()PermissionEr 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()IntegerRuft die Anzahl von Byte ab, die zum Speichern von File in Drive verwendet werden.
getTargetId()StringBei einem Shortcut wird die ID des Elements zurückgegeben, auf das es verweist.
getTargetMimeType()StringBei einem Shortcut wird der MIME-Typ des Elements zurückgegeben, auf das es verweist.
getTargetResourceKey()StringWenn es sich bei der Datei um eine Verknüpfung handelt, wird der Ressourcenschlüssel des Elements zurückgegeben, auf das sie verweist.
getThumbnail()BlobRuft eine Miniaturansicht für die Datei ab oder null, wenn keine Miniaturansicht vorhanden ist.
getUrl()StringRuft 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()BooleanLegt fest, ob Nutzer mit Bearbeitungsberechtigungen für File folgende Aktionen ausführen dürfen: für andere Nutzer freigeben oder die Berechtigungen ändern.
isStarred()BooleanLegt fest, ob das File im Drive des Nutzers markiert wurde.
isTrashed()BooleanLegt fest, ob sich das File im Papierkorb der Ablage des Nutzers befindet.
makeCopy()FileErstellt eine Kopie der Datei.
makeCopy(destination)FileErstellt eine Kopie der Datei im Zielverzeichnis.
makeCopy(name)FileErstellt eine Kopie der Datei und gibt ihr den angegebenen Namen.
makeCopy(name, destination)FileErstellt eine Kopie der Datei im Zielverzeichnis und gibt ihr den angegebenen Namen.
moveTo(destination)FileVerschiebt dieses Element in den angegebenen Zielordner.
removeCommenter(emailAddress)FileEntfernt den angegebenen Nutzer aus der Liste der Kommentatoren für das File.
removeCommenter(user)FileEntfernt den angegebenen Nutzer aus der Liste der Kommentatoren für das File.
removeEditor(emailAddress)FileEntfernt den angegebenen Nutzer aus der Liste der Bearbeiter für File.
removeEditor(user)FileEntfernt den angegebenen Nutzer aus der Liste der Bearbeiter für File.
removeViewer(emailAddress)FileEntfernt den angegebenen Nutzer aus der Liste der Betrachter und Kommentatoren für das File.
removeViewer(user)FileEntfernt den angegebenen Nutzer aus der Liste der Betrachter und Kommentatoren für das File.
revokePermissions(emailAddress)FileHebt den Zugriff auf die File auf, die dem angegebenen Nutzer gewährt wurde.
revokePermissions(user)FileHebt 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)FileLegt die Beschreibung für das File fest.
setName(name)FileLegt 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)FileLegt fest, ob File einen Ressourcenschlüssel für den Zugriff benötigt, wenn er die über einen Link freigegeben wurden.
setShareableByEditors(shareable)FileLegt fest, ob Nutzer mit Bearbeitungsberechtigungen für die File Dateien freigeben dürfen oder die Berechtigungen zu ändern.
setSharing(accessType, permissionType)FileLegt 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)FileLegt fest, ob das File im Drive des Nutzers markiert ist.
setTrashed(trashed)FileLegt fest, ob sich die File im Papierkorb der Ablage des Nutzers befindet.

FileIterator

Methoden

MethodeRückgabetypKurzbeschreibung
getContinuationToken()StringRuft ein Token ab, mit dem diese Iteration zu einem späteren Zeitpunkt fortgesetzt werden kann.
hasNext()BooleanLegt fest, ob beim Aufrufen von next() ein Element zurückgegeben wird.
next()FileRuft das nächste Element in der Sammlung von Dateien oder Ordnern ab.

Folder

Methoden

MethodeRückgabetypKurzbeschreibung
addEditor(emailAddress)FolderFügt den angegebenen Nutzer der Liste der Bearbeiter für Folder hinzu.
addEditor(user)FolderFügt den angegebenen Nutzer der Liste der Bearbeiter für Folder hinzu.
addEditors(emailAddresses)FolderFügt das angegebene Array von Nutzern der Liste der Bearbeiter für Folder hinzu.
addViewer(emailAddress)FolderFügt den angegebenen Nutzer der Liste der Betrachter für das Folder hinzu.
addViewer(user)FolderFügt den angegebenen Nutzer der Liste der Betrachter für das Folder hinzu.
addViewers(emailAddresses)FolderFügt das angegebene Array von Nutzern der Betrachterliste für Folder hinzu.
createFile(blob)FileErstellt im aktuellen Ordner eine Datei aus einer bestimmten Blob mit beliebigen Daten.
createFile(name, content)FileErstellt im aktuellen Ordner eine Textdatei mit dem angegebenen Namen und Inhalt.
createFile(name, content, mimeType)FileErstellt im aktuellen Ordner eine Datei mit dem angegebenen Namen, Inhalt und MIME-Typ.
createFolder(name)FolderErstellt im aktuellen Ordner einen Ordner mit dem angegebenen Namen.
createShortcut(targetId)FileErstellt eine Verknüpfung zur angegebenen Drive-Element-ID und gibt sie zurück.
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)FileEine Verknüpfung zur angegebenen Drive-Element-ID und dem Ressourcenschlüssel wird erstellt und zurückgegeben.
getAccess(email)PermissionRuft die Berechtigung ab, die dem angegebenen Nutzer gewährt wurde.
getAccess(user)PermissionRuft die Berechtigung ab, die dem angegebenen Nutzer gewährt wurde.
getDateCreated()DateRuft das Datum ab, an dem die Folder erstellt wurde.
getDescription()StringRuft die Beschreibung für den Folder ab.
getEditors()User[]Ruft die Liste der Bearbeiter für dieses Folder-Element ab.
getFiles()FileIteratorRuft eine Sammlung aller Dateien ab, die dem aktuellen Ordner untergeordnet sind.
getFilesByName(name)FileIteratorRuft eine Sammlung aller Dateien ab, die dem aktuellen Ordner untergeordnet sind und den angegebenen Namen haben.
getFilesByType(mimeType)FileIteratorRuft eine Sammlung aller Dateien ab, die dem aktuellen Ordner untergeordnet sind und den angegebenen MIME-Typ haben.
getFolders()FolderIteratorRuft eine Sammlung aller Ordner ab, die dem aktuellen Ordner untergeordnet sind.
getFoldersByName(name)FolderIteratorRuft eine Sammlung aller Ordner ab, die dem aktuellen Ordner untergeordnet sind und den angegebenen Namen haben.
getId()StringRuft die ID von Folder ab.
getLastUpdated()DateRuft das Datum ab, an dem die Folder zuletzt aktualisiert wurde.
getName()StringRuft den Namen des Folder ab.
getOwner()UserRuft den Eigentümer von Folder ab.
getParents()FolderIteratorRuft eine Sammlung von Ordnern ab, die dem Folder unmittelbar übergeordnet sind.
getResourceKey()StringRuft den Ressourcenschlüssel der Folder ab, die für den Zugriff auf Elemente erforderlich ist, die wurden über einen Link freigegeben.
getSecurityUpdateEligible()BooleanRuft 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()BooleanRuft ab, ob dieser Folder einen Ressourcenschlüssel für den Zugriff benötigt, wenn er die über einen Link freigegeben wurden.
getSharingAccess()AccessRuft ab, welche Klasse von Nutzern außer auf einzelne Nutzer auf das Folder zugreifen kann Nutzern, denen explizit Zugriff gewährt wurde.
getSharingPermission()PermissionEr 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()IntegerRuft die Anzahl von Byte ab, die zum Speichern von Folder in Drive verwendet werden.
getUrl()StringRuft 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()BooleanLegt fest, ob Nutzer mit Bearbeitungsberechtigungen für Folder folgende Aktionen ausführen dürfen: für andere Nutzer freigeben oder die Berechtigungen ändern.
isStarred()BooleanLegt fest, ob das Folder im Drive des Nutzers markiert wurde.
isTrashed()BooleanLegt fest, ob sich das Folder im Papierkorb der Ablage des Nutzers befindet.
moveTo(destination)FolderVerschiebt dieses Element in den angegebenen Zielordner.
removeEditor(emailAddress)FolderEntfernt den angegebenen Nutzer aus der Liste der Bearbeiter für Folder.
removeEditor(user)FolderEntfernt den angegebenen Nutzer aus der Liste der Bearbeiter für Folder.
removeViewer(emailAddress)FolderEntfernt den angegebenen Nutzer aus der Liste der Betrachter und Kommentatoren für das Folder.
removeViewer(user)FolderEntfernt den angegebenen Nutzer aus der Liste der Betrachter und Kommentatoren für das Folder.
revokePermissions(emailAddress)FolderHebt den Zugriff auf die Folder auf, die dem angegebenen Nutzer gewährt wurde.
revokePermissions(user)FolderHebt den Zugriff auf die Folder auf, die dem angegebenen Nutzer gewährt wurde.
searchFiles(params)FileIteratorRuft eine Sammlung aller Dateien ab, die dem aktuellen Ordner untergeordnet sind und der angegebenen Suche entsprechen Kriterien.
searchFolders(params)FolderIteratorRuft eine Sammlung aller Ordner ab, die dem aktuellen Ordner untergeordnet sind und der angegebenen Suche entsprechen Kriterien.
setDescription(description)FolderLegt die Beschreibung für das Folder fest.
setName(name)FolderLegt 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)FolderLegt fest, ob Folder einen Ressourcenschlüssel für den Zugriff benötigt, wenn er die über einen Link freigegeben wurden.
setShareableByEditors(shareable)FolderLegt fest, ob Nutzer mit Bearbeitungsberechtigungen für die Folder Dateien freigeben dürfen oder die Berechtigungen zu ändern.
setSharing(accessType, permissionType)FolderLegt 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)FolderLegt fest, ob das Folder im Drive des Nutzers markiert ist.
setTrashed(trashed)FolderLegt fest, ob sich die Folder im Papierkorb der Ablage des Nutzers befindet.

FolderIterator

Methoden

MethodeRückgabetypKurzbeschreibung
getContinuationToken()StringRuft ein Token ab, mit dem diese Iteration zu einem späteren Zeitpunkt fortgesetzt werden kann.
hasNext()BooleanLegt fest, ob beim Aufrufen von next() ein Element zurückgegeben wird.
next()FolderRuft das nächste Element in der Sammlung von Dateien oder Ordnern ab.

Permission

Attribute

AttributTypBeschreibung
VIEWEnumNutzer mit Zugriff auf die Datei oder den Ordner können die Datei oder den Ordner nur ansehen oder kopieren.
EDITEnumNutzer, die Zugriff auf die Datei oder den Ordner haben, können die Datei oder den Ordner bearbeiten.
COMMENTEnumNutzer mit Zugriff auf die Datei oder den Ordner können die Datei oder den Ordner nur ansehen, kopieren oder kommentieren.
OWNEREnumDer Nutzer ist Eigentümer der Datei oder des Ordners.
ORGANIZEREnumNutzer, die Dateien und Ordner in einer geteilten Ablage organisieren können.
FILE_ORGANIZEREnumNutzer, die Inhalte in einer geteilten Ablage bearbeiten, in den Papierkorb verschieben und verschieben dürfen.
NONEEnumDer Nutzer hat keine Berechtigungen für die Datei oder den Ordner.

User

Methoden

MethodeRückgabetypKurzbeschreibung
getDomain()StringRuft den Domainnamen ab, der dem Konto des Nutzers zugeordnet ist.
getEmail()StringRuft die E-Mail-Adresse des Nutzers ab.
getName()StringRuft den Namen des Nutzers ab.
getPhotoUrl()StringRuft die URL für das Nutzerfoto ab.