Mit diesem Dienst können Skripts Dateien und Ordner in Google Drive erstellen, suchen und ändern. Der integrierte Drive-Dienst ist zwar einfacher zu verwenden, hat aber einige Einschränkungen. Wenn Sie die neuesten Funktionen und den neuesten Support nutzen und auf Dateien oder Ordner in geteilten Ablagen zugreifen möchten, verwenden Sie den erweiterten Drive-Dienst.
Wenn in Ihrem Skript ein Standard-Cloud-Projekt anstelle eines Standard-Cloud-Projekts verwendet wird, müssen Sie die Drive API manuell aktivieren. Aktivieren Sie die Drive API in Ihrem Standard-Cloud-Projekt:
Das folgende Codebeispiel zeigt, wie Sie die Namen jeder Datei im Ordner „Meine Ablage“ des Nutzers protokollieren:// 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());
}Klassen
| Name | Kurzbeschreibung |
|---|---|
Access | Eine Enumeration, die Nutzerklassen darstellt, die neben einzelnen Nutzern, denen explizit Zugriff gewährt wurde, auf eine Datei oder einen Ordner zugreifen können. |
Drive | Ermöglicht es Scripts, Dateien und Ordner in Google Drive zu erstellen, zu suchen und zu ändern. |
File | Eine Datei in Google Drive |
File | Ein Iterator, mit dem in Skripts über eine potenziell große Sammlung von Dateien iteriert werden kann. |
Folder | Ein Ordner in Google Drive. |
Folder | Ein Objekt, mit dem Skripts eine potenziell große Sammlung von Ordnern durchlaufen können. |
Permission | Ein Enum, das die Berechtigungen darstellt, die Nutzern gewährt werden, die auf eine Datei oder einen Ordner zugreifen können, abgesehen von einzelnen Nutzern, 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, darf das Element öffnen. |
DOMAIN | Enum | Nutzer in Ihrer Domain können die Datei suchen und darauf zugreifen. |
DOMAIN_WITH_LINK | Enum | Nutzer 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. |
Drive App
Attribute
| Attribut | Typ | Beschreibung |
|---|---|---|
Access | Access | Eine Enumeration, die Nutzerklassen darstellt, die neben einzelnen Nutzern, denen explizit Zugriff gewährt wurde, auf eine Datei oder einen Ordner zugreifen können. |
Permission | Permission | Ein Enum, das die Berechtigungen darstellt, die Nutzern gewährt werden, die auf eine Datei oder einen Ordner zugreifen können, abgesehen von einzelnen Nutzern, denen explizit Zugriff gewährt wurde. |
Methoden
| Methode | Rückgabetyp | Kurzbeschreibung |
|---|---|---|
continue | File | Setzt eine Dateiiteration mit einem Fortsetzungstoken aus einem vorherigen Iterator fort. |
continue | Folder | Setzt eine Ordneriteration mit einem Fortsetzungstoken aus einem vorherigen Iterator fort. |
create | File | Erstellt eine Datei im Stammverzeichnis des Drive-Kontos des Nutzers aus einem bestimmten Blob mit beliebigen Daten. |
create | File | Erstellt eine Textdatei im Stammverzeichnis der Ablage des Nutzers mit dem angegebenen Namen und Inhalt. |
create | File | Erstellt eine Datei im Stammverzeichnis des Nutzers in Drive mit dem angegebenen Namen, Inhalt und MIME-Typ. |
create | Folder | Erstellt einen Ordner im Stammverzeichnis des Drive des Nutzers mit dem angegebenen Namen. |
create | File | Erstellt eine Verknüpfung zur angegebenen Drive-Element-ID und gibt sie zurück. |
create | File | Erstellt eine Verknüpfung zur angegebenen Drive-Element-ID und zum angegebenen Ressourcenschlüssel und gibt sie zurück. |
enforce | void | Aktiviert oder deaktiviert das Verhalten „enforceSingleParent“ für alle Aufrufe, die sich auf übergeordnete Elemente von Elementen auswirken. |
get | File | Ruft die Datei mit der angegebenen ID ab. |
get | File | Ruft die Datei mit der angegebenen ID und dem angegebenen Ressourcenschlüssel ab. |
get | File | Ruft eine Sammlung aller Dateien im Drive des Nutzers ab. |
get | File | Ruft eine Sammlung aller Dateien im Drive des Nutzers ab, die den angegebenen Namen haben. |
get | File | Ruft eine Sammlung aller Dateien im Drive des Nutzers ab, die den angegebenen MIME-Typ haben. |
get | Folder | Ruft den Ordner mit der angegebenen ID ab. |
get | Folder | Ruft den Ordner mit der angegebenen ID und dem angegebenen Ressourcenschlüssel ab. |
get | Folder | Ruft eine Sammlung aller Ordner im Drive des Nutzers ab. |
get | Folder | Ruft eine Sammlung aller Ordner im Drive des Nutzers ab, die den angegebenen Namen haben. |
get | Folder | Ruft den Ordner im Stammverzeichnis des Drive des Nutzers ab. |
get | Integer | Gibt die Anzahl der Byte zurück, die der Nutzer in Drive speichern darf. |
get | Integer | Gibt die Anzahl der Byte zurück, die der Nutzer derzeit in Drive speichert. |
get | File | Ruft eine Sammlung aller Dateien im Papierkorb des Drive-Kontos des Nutzers ab. |
get | Folder | Ruft eine Sammlung aller Ordner im Papierkorb des Drive-Kontos des Nutzers ab. |
search | File | Ruft eine Sammlung aller Dateien in der Ablage des Nutzers ab, die den angegebenen Suchkriterien entsprechen. |
search | Folder | Ruft eine Sammlung aller Ordner im Drive des Nutzers ab, die den angegebenen Suchkriterien entsprechen. |
File
Methoden
| Methode | Rückgabetyp | Kurzbeschreibung |
|---|---|---|
add | File | Fügen Sie den angegebenen Nutzer der Liste der Kommentatoren für File hinzu. |
add | File | Fügen Sie den angegebenen Nutzer der Liste der Kommentatoren für File hinzu. |
add | File | Füge das angegebene Nutzer-Array der Liste der Kommentatoren für File hinzu. |
add | File | Fügt den angegebenen Nutzer der Liste der Bearbeiter für File hinzu. |
add | File | Fügt den angegebenen Nutzer der Liste der Bearbeiter für File hinzu. |
add | File | Fügt das angegebene Nutzer-Array der Liste der Bearbeiter für File hinzu. |
add | File | Fügt den angegebenen Nutzer der Liste der Zuschauer für File hinzu. |
add | File | Fügt den angegebenen Nutzer der Liste der Zuschauer für File hinzu. |
add | File | Fügt das angegebene Nutzer-Array der Liste der Betrachter für File hinzu. |
get | Permission | Ruft die Berechtigung ab, die einem bestimmten Nutzer gewährt wurde. |
get | Permission | Ruft die Berechtigung ab, die einem bestimmten Nutzer gewährt wurde. |
get | Blob | Gibt die Daten in diesem Objekt als Blob zurück, das in den angegebenen Inhaltstyp konvertiert wurde. |
get | Blob | Gibt die Daten in diesem Objekt als Blob zurück. |
get | Date | Gibt das Datum zurück, an dem File erstellt wurde. |
get | String | Ruft die Beschreibung für die File ab. |
get | String | Ruft die URL ab, die zum Herunterladen der Datei verwendet werden kann. |
get | User[] | Ruft die Liste der Mitbearbeiter für diese File ab. |
get | String | Ruft die ID des File ab. |
get | Date | Gibt das Datum zurück, an dem File zuletzt aktualisiert wurde. |
get | String | Ruft den MIME-Typ der Datei ab. |
get | String | Ruft den Namen des File ab. |
get | User | Ruft den Dateieigentümer ab. |
get | Folder | Ruft eine Sammlung von Ordnern ab, die unmittelbar übergeordnete Elemente von File sind. |
get | String | Ruft den Ressourcenschlüssel des File ab, der für den Zugriff auf Elemente erforderlich ist, die über einen Link freigegeben wurden. |
get | Boolean | Gibt an, ob für dieses File das Sicherheitsupdate angewendet werden kann, für das ein Ressourcenschlüssel für den Zugriff erforderlich ist, wenn es über einen Link freigegeben wird. |
get | Boolean | Gibt an, ob für den Zugriff auf diese File ein Ressourcenschlüssel erforderlich ist, wenn sie über einen Link freigegeben wird. |
get | Access | Ruft ab, welche Nutzerklasse auf die File zugreifen kann, abgesehen von einzelnen Nutzern, denen explizit Zugriff gewährt wurde. |
get | Permission | Ruft die Berechtigung ab, die Nutzern mit Zugriff auf File gewährt wird, mit Ausnahme von einzelnen Nutzern, denen explizit Zugriff gewährt wurde. |
get | Integer | Gibt die Anzahl der Byte zurück, die zum Speichern des File in Drive verwendet werden. |
get | String | Wenn es sich um eine Verknüpfung handelt, wird die ID des Elements zurückgegeben, auf das sie verweist. |
get | String | Wenn es sich um eine Verknüpfung handelt, wird der MIME-Typ des Elements zurückgegeben, auf das sie verweist. |
get | String | Wenn die Datei eine Verknüpfung ist, wird der Ressourcenschlüssel des Elements zurückgegeben, auf das sie verweist. |
get | Blob|null | Ruft eine Miniaturansicht für die Datei ab oder null, wenn keine Miniaturansicht vorhanden ist. |
get | String | Ruft die URL ab, mit der die File in einer Google-App wie Drive oder Docs geöffnet werden kann. |
get | User[] | Ruft die Liste der Betrachter und Kommentatoren für diese File ab. |
is | Boolean | Bestimmt, ob Nutzer mit Bearbeitungsberechtigungen für die File die Datei für andere Nutzer freigeben oder die Berechtigungen ändern dürfen. |
is | Boolean | Gibt an, ob das File in Google Drive des Nutzers mit einem Sternchen markiert wurde. |
is | Boolean | Gibt an, ob sich die File im Papierkorb des Drive-Kontos des Nutzers befindet. |
make | File | Erstellt eine Kopie der Datei. |
make | File | Erstellt eine Kopie der Datei im Zielverzeichnis. |
make | File | Erstellt eine Kopie der Datei und benennt sie mit dem angegebenen Namen. |
make | File | Erstellt eine Kopie der Datei im Zielverzeichnis und benennt sie mit dem angegebenen Namen. |
move | File | Verschiebt dieses Element in den angegebenen Zielordner. |
remove | File | Entfernt den angegebenen Nutzer aus der Liste der Kommentatoren für die File. |
remove | File | Entfernt den angegebenen Nutzer aus der Liste der Kommentatoren für die File. |
remove | File | Entfernt den angegebenen Nutzer aus der Liste der Mitbearbeiter für die File. |
remove | File | Entfernt den angegebenen Nutzer aus der Liste der Mitbearbeiter für die File. |
remove | File | Entfernt den angegebenen Nutzer aus der Liste der Zuschauer und Kommentatoren für die File. |
remove | File | Entfernt den angegebenen Nutzer aus der Liste der Zuschauer und Kommentatoren für die File. |
revoke | File | Widerruft den Zugriff auf File, der dem angegebenen Nutzer gewährt wurde. |
revoke | File | Widerruft den Zugriff auf File, der dem angegebenen Nutzer gewährt wurde. |
set | File | Überschreibt den Inhalt der Datei mit einem angegebenen Ersatz. |
set | File | Legt die Beschreibung für File fest. |
set | File | Legt den Namen des File fest. |
set | File | Ändert den Inhaber von File. |
set | File | Ändert den Inhaber von File. |
set | File | Legt fest, ob für den Zugriff auf File ein Ressourcenschlüssel erforderlich ist, wenn die Datei über einen Link freigegeben wird. |
set | File | Gibt an, ob Nutzer mit Bearbeitungsberechtigungen für die File die Datei für andere Nutzer freigeben oder die Berechtigungen ändern dürfen. |
set | File | Legt fest, welche Nutzerklasse auf File zugreifen kann und welche Berechtigungen diesen Nutzern erteilt werden, abgesehen von einzelnen Nutzern, denen explizit Zugriff gewährt wurde. |
set | File | Legt fest, ob die File in Google Drive des Nutzers mit einem Sternchen markiert ist. |
set | File | Legt fest, ob sich die File im Papierkorb des Drive-Kontos des Nutzers befindet. |
File Iterator
Methoden
| Methode | Rückgabetyp | Kurzbeschreibung |
|---|---|---|
get | String | Ruft ein Token ab, das verwendet werden kann, um diese Iteration zu einem späteren Zeitpunkt fortzusetzen. |
has | 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 |
|---|---|---|
add | Folder | Fügt den angegebenen Nutzer der Liste der Bearbeiter für Folder hinzu. |
add | Folder | Fügt den angegebenen Nutzer der Liste der Bearbeiter für Folder hinzu. |
add | Folder | Fügt das angegebene Nutzer-Array der Liste der Bearbeiter für Folder hinzu. |
add | Folder | Fügt den angegebenen Nutzer der Liste der Zuschauer für Folder hinzu. |
add | Folder | Fügt den angegebenen Nutzer der Liste der Zuschauer für Folder hinzu. |
add | Folder | Fügt das angegebene Nutzer-Array der Liste der Betrachter für Folder hinzu. |
create | File | Erstellt eine Datei im aktuellen Ordner aus einem angegebenen Blob mit beliebigen Daten. |
create | File | Erstellt im aktuellen Ordner eine Textdatei mit dem angegebenen Namen und Inhalt. |
create | File | Erstellt eine Datei im aktuellen Ordner mit dem angegebenen Namen, Inhalt und MIME-Typ. |
create | Folder | Erstellt im aktuellen Ordner einen Ordner mit dem angegebenen Namen. |
create | File | Erstellt eine Verknüpfung zur angegebenen Drive-Element-ID und gibt sie zurück. |
create | File | Erstellt eine Verknüpfung zur angegebenen Drive-Element-ID und zum angegebenen Ressourcenschlüssel und gibt sie zurück. |
get | Permission | Ruft die Berechtigung ab, die einem bestimmten Nutzer gewährt wurde. |
get | Permission | Ruft die Berechtigung ab, die einem bestimmten Nutzer gewährt wurde. |
get | Date | Gibt das Datum zurück, an dem Folder erstellt wurde. |
get | String | Ruft die Beschreibung für die Folder ab. |
get | User[] | Ruft die Liste der Mitbearbeiter für diese Folder ab. |
get | File | Ruft eine Sammlung aller Dateien ab, die untergeordnete Elemente des aktuellen Ordners sind. |
get | File | Ruft eine Sammlung aller Dateien ab, die untergeordnete Elemente des aktuellen Ordners sind und den angegebenen Namen haben. |
get | File | Ruft eine Sammlung aller Dateien ab, die untergeordnete Elemente des aktuellen Ordners sind und den angegebenen MIME-Typ haben. |
get | Folder | Ruft eine Sammlung aller Ordner ab, die untergeordnete Elemente des aktuellen Ordners sind. |
get | Folder | Ruft eine Sammlung aller Ordner ab, die untergeordnete Elemente des aktuellen Ordners sind und den angegebenen Namen haben. |
get | String | Ruft die ID des Folder ab. |
get | Date | Gibt das Datum zurück, an dem Folder zuletzt aktualisiert wurde. |
get | String | Ruft den Namen des Folder ab. |
get | User | Ruft den Eigentümer dieses Folder ab. |
get | Folder | Ruft eine Sammlung von Ordnern ab, die unmittelbar übergeordnete Elemente von Folder sind. |
get | String | Ruft den Ressourcenschlüssel des Folder ab, der für den Zugriff auf Elemente erforderlich ist, die über einen Link freigegeben wurden. |
get | Boolean | Gibt an, ob für dieses Folder das Sicherheitsupdate angewendet werden kann, für das ein Ressourcenschlüssel für den Zugriff erforderlich ist, wenn es über einen Link freigegeben wird. |
get | Boolean | Gibt an, ob für den Zugriff auf diese Folder ein Ressourcenschlüssel erforderlich ist, wenn sie über einen Link freigegeben wird. |
get | Access | Ruft ab, welche Nutzerklasse auf die Folder zugreifen kann, abgesehen von einzelnen Nutzern, denen explizit Zugriff gewährt wurde. |
get | Permission | Ruft die Berechtigung ab, die Nutzern mit Zugriff auf Folder gewährt wird, mit Ausnahme von einzelnen Nutzern, denen explizit Zugriff gewährt wurde. |
get | Integer | Gibt die Anzahl der Byte zurück, die zum Speichern des Folder in Drive verwendet werden. |
get | String | Ruft die URL ab, mit der die Folder in einer Google-App wie Drive oder Docs geöffnet werden kann. |
get | User[] | Ruft die Liste der Betrachter und Kommentatoren für diese Folder ab. |
is | Boolean | Bestimmt, ob Nutzer mit Bearbeitungsberechtigungen für die Folder die Datei für andere Nutzer freigeben oder die Berechtigungen ändern dürfen. |
is | Boolean | Gibt an, ob das Folder in Google Drive des Nutzers mit einem Sternchen markiert wurde. |
is | Boolean | Gibt an, ob sich die Folder im Papierkorb des Drive-Kontos des Nutzers befindet. |
move | Folder | Verschiebt dieses Element in den angegebenen Zielordner. |
remove | Folder | Entfernt den angegebenen Nutzer aus der Liste der Mitbearbeiter für die Folder. |
remove | Folder | Entfernt den angegebenen Nutzer aus der Liste der Mitbearbeiter für die Folder. |
remove | Folder | Entfernt den angegebenen Nutzer aus der Liste der Zuschauer und Kommentatoren für die Folder. |
remove | Folder | Entfernt den angegebenen Nutzer aus der Liste der Zuschauer und Kommentatoren für die Folder. |
revoke | Folder | Widerruft den Zugriff auf Folder, der dem angegebenen Nutzer gewährt wurde. |
revoke | Folder | Widerruft den Zugriff auf Folder, der dem angegebenen Nutzer gewährt wurde. |
search | File | Ruft eine Sammlung aller Dateien ab, die untergeordnete Elemente des aktuellen Ordners sind und den angegebenen Suchkriterien entsprechen. |
search | Folder | Ruft eine Sammlung aller Ordner ab, die untergeordnete Elemente des aktuellen Ordners sind und den angegebenen Suchkriterien entsprechen. |
set | Folder | Legt die Beschreibung für Folder fest. |
set | Folder | Legt den Namen des Folder fest. |
set | Folder | Ändert den Inhaber von Folder. |
set | Folder | Ändert den Inhaber von Folder. |
set | Folder | Legt fest, ob für den Zugriff auf Folder ein Ressourcenschlüssel erforderlich ist, wenn die Datei über einen Link freigegeben wird. |
set | Folder | Gibt an, ob Nutzer mit Bearbeitungsberechtigungen für die Folder die Datei für andere Nutzer freigeben oder die Berechtigungen ändern dürfen. |
set | Folder | Legt fest, welche Nutzerklasse auf Folder zugreifen kann und welche Berechtigungen diesen Nutzern erteilt werden, abgesehen von einzelnen Nutzern, denen explizit Zugriff gewährt wurde. |
set | Folder | Legt fest, ob die Folder in Google Drive des Nutzers mit einem Sternchen markiert ist. |
set | Folder | Legt fest, ob sich die Folder im Papierkorb des Drive-Kontos des Nutzers befindet. |
Folder Iterator
Methoden
| Methode | Rückgabetyp | Kurzbeschreibung |
|---|---|---|
get | String | Ruft ein Token ab, das verwendet werden kann, um diese Iteration zu einem späteren Zeitpunkt fortzusetzen. |
has | 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 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 |
|---|---|---|
get | String|null | Ruft den Domainnamen ab, der mit dem Konto des Nutzers verknüpft ist. |
get | String|null | Ruft die E-Mail-Adresse des Nutzers ab. |
get | String|null | Ruft den Namen des Nutzers ab. |
get | String|null | Ruft die URL für das Foto des Nutzers ab. |