Mit diesem Dienst können Scripts 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 Support nutzen und auf Dateien oder Ordner in geteilten Ablagen zugreifen möchten, verwenden Sie den erweiterten Drive-Dienst.
Wenn in Ihrem Script ein Standard-Cloud-Projekt anstelle eines Standard-Cloud-Projekts verwendet wird, müssen Sie die Drive API manuell aktivieren. Aktivieren Sie in Ihrem Standard-Cloud-Projekt die Drive API:
Im folgenden Codebeispiel wird gezeigt, wie die Namen aller Dateien im Ordner „Mein Drive“ des Nutzers protokolliert werden:// 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 | Ein Enum, das Nutzergruppen 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 finden und zu ändern. |
File | Eine Datei in Google Drive. |
File | Ein Iterator, mit dem Scripts eine potenziell große Sammlung von Dateien durchgehen können. |
Folder | Einen Ordner in Google Drive. |
Folder | Ein Objekt, mit dem Scripts eine potenziell große Sammlung von Ordnern durchlaufen können. |
Permission | Ein Enum, das die Berechtigungen für Nutzer darstellt, die auf eine Datei oder einen Ordner zugreifen können, zusätzlich zu einzelnen Nutzern, denen ausdrücklich 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 | 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 | Ein Enum, das Nutzergruppen 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, das die Berechtigungen darstellt, die Nutzern gewährt wurden, die auf eine Datei oder einen Ordner zugreifen können, zusätzlich zu einzelnen Nutzern, die ausdrücklich Zugriff erhalten haben. |
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
continue | File | Setzt eine Dateiiteration mit einem Fortsetzungstoken aus einem vorherigen Iterator fort. |
continue | Folder | Eine Ordneriteration wird mit einem Fortsetzungstoken aus einem vorherigen Iterator fortgesetzt. |
create | File | Erstellt eine Datei im Stammverzeichnis des Drive-Ordners des Nutzers aus einer bestimmten Blob mit beliebigen Daten. |
create | File | Erstellt eine Textdatei im Stammverzeichnis des Drive-Ordners des Nutzers mit dem angegebenen Namen und Inhalt. |
create | File | Erstellt eine Datei im Stammverzeichnis des Drive-Ordners des Nutzers mit dem angegebenen Namen, Inhalt und MIME-Typ. |
create | Folder | Erstellt einen Ordner im Stammverzeichnis des Drive-Ordners 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 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 Artikeln auswirken. |
get | File | Ruft die Datei mit der angegebenen ID ab. |
get | File | Ruft die Datei mit der angegebenen ID und dem Ressourcenschlüssel ab. |
get | File | Eine Sammlung aller Dateien im Drive des Nutzers wird abgerufen. |
get | File | Ruft eine Sammlung aller Dateien im Drive des Nutzers ab, die den angegebenen Namen haben. |
get | File | Stellt eine Sammlung aller Dateien in der Google Drive-Ablage des Nutzers mit dem angegebenen MIME-Typ bereit. |
get | Folder | Ruft den Ordner mit der angegebenen ID ab. |
get | Folder | Ruft den Ordner mit der angegebenen ID und dem Ressourcenschlüssel ab. |
get | Folder | Eine Sammlung aller Ordner im Drive des Nutzers wird abgerufen. |
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-Ordners des Nutzers ab. |
get | Integer | Ruft die Anzahl der Byte ab, die der Nutzer in Drive speichern darf. |
get | Integer | Die Anzahl der Byte, die der Nutzer derzeit in Drive speichert. |
get | File | Stellt eine Sammlung aller Dateien im Papierkorb des Nutzers in Google Drive bereit. |
get | Folder | Hiermit wird eine Sammlung aller Ordner im Papierkorb des Drive-Kontos des Nutzers abgerufen. |
search | File | Ruft eine Sammlung aller Dateien im Drive des Nutzers ab, die den angegebenen Suchkriterien entsprechen. |
search | Folder | Stellt eine Sammlung aller Ordner im Drive des Nutzers zurück, 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 die File hinzu. |
add | File | Fügen Sie den angegebenen Nutzer der Liste der Kommentatoren für die File hinzu. |
add | File | Füge der Liste der Kommentatoren für die File das angegebene Array von Nutzern hinzu. |
add | File | Der angegebene Nutzer wird der Liste der Mitbearbeiter für die File hinzugefügt. |
add | File | Der angegebene Nutzer wird der Liste der Mitbearbeiter für die File hinzugefügt. |
add | File | Fügt der Liste der Mitbearbeiter für die File das angegebene Nutzerarray hinzu. |
add | File | Der angegebene Nutzer wird der Liste der Zuschauer für die File hinzugefügt. |
add | File | Der angegebene Nutzer wird der Liste der Zuschauer für die File hinzugefügt. |
add | File | Fügen Sie der Liste der Zuschauer für die File das angegebene Array von Nutzern 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, der in den angegebenen Inhaltstyp konvertiert wurde. |
get | Blob | Gibt die Daten in diesem Objekt als Blob zurück. |
get | Date | Das Datum, an dem die File erstellt wurde. |
get | String | Ruft die Beschreibung für die File ab. |
get | String | Ruft die URL ab, über die die Datei heruntergeladen werden kann. |
get | User[] | Ruft die Liste der Mitbearbeiter für diese File ab. |
get | String | Ruft die ID der File ab. |
get | Date | Das Datum, an dem die File zuletzt aktualisiert wurde. |
get | String | Ruft den MIME-Typ der Datei ab. |
get | String | Ruft den Namen der File ab. |
get | User | Ruft den Eigentümer der Datei ab. |
get | Folder | Eine Sammlung von Ordnern wird abgerufen, die unmittelbar übergeordnete Elemente von File sind. |
get | String | Ruft den Ressourcenschlüssel der File ab, der zum Zugriff auf Elemente erforderlich ist, die über einen Link freigegeben wurden. |
get | Boolean | Gibt an, ob für diese File das Sicherheitsupdate angewendet werden kann, für das ein Ressourcenschlüssel für den Zugriff erforderlich ist, wenn die Datei über einen Link freigegeben wird. |
get | Boolean | Gibt an, ob für diese File ein Ressourcenschlüssel für den Zugriff erforderlich ist, wenn sie über einen Link freigegeben wird. |
get | Access | Gibt an, welche Nutzergruppe neben einzelnen Nutzern, denen explizit Zugriff gewährt wurde, auf das File zugreifen kann. |
get | Permission | Ruft die Berechtigung ab, die den Nutzern gewährt wurde, die auf die File zugreifen können, sowie die Berechtigung einzelner Nutzer, denen explizit Zugriff gewährt wurde. |
get | Integer | Die Anzahl der Byte, die zum Speichern der File in Drive verwendet werden. |
get | String | Wenn es sich um einen Verknüpfung handelt, wird die ID des Elements zurückgegeben, auf das sie verweist. |
get | String | Wenn es sich um einen Verknüpfung handelt, wird der MIME-Typ des Elements zurückgegeben, auf das sie verweist. |
get | String | Wenn es sich bei der Datei um einen Verknüpfung handelt, wird der Ressourcenschlüssel des Elements zurückgegeben, auf das sie verweist. |
get | Blob | Hier wird ein Thumbnail-Bild für die Datei abgerufen oder null , wenn kein Thumbnail vorhanden ist. |
get | String | Die URL, 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 Inhalte für andere Nutzer freigeben oder die Berechtigungen ändern dürfen. |
is | Boolean | Gibt an, ob die File im Drive des Nutzers mit einem Stern markiert wurde. |
is | Boolean | Bestimmt, ob sich die File im Papierkorb des Nutzers in Google Drive 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 | Der angegebene Nutzer wird aus der Liste der Kommentatoren für die File entfernt. |
remove | File | Der angegebene Nutzer wird aus der Liste der Kommentatoren für die File entfernt. |
remove | File | Der angegebene Nutzer wird aus der Liste der Mitbearbeiter der File entfernt. |
remove | File | Der angegebene Nutzer wird aus der Liste der Mitbearbeiter der File entfernt. |
remove | File | Der angegebene Nutzer wird aus der Liste der Zuschauer und Kommentatoren für die File entfernt. |
remove | File | Der angegebene Nutzer wird aus der Liste der Zuschauer und Kommentatoren für die File entfernt. |
revoke | File | Hiermit wird der dem Nutzer gewährte Zugriff auf File widerrufen. |
revoke | File | Hiermit wird der dem Nutzer gewährte Zugriff auf File widerrufen. |
set | File | Der Inhalt der Datei wird durch einen bestimmten Ersatz überschrieben. |
set | File | Legt die Beschreibung für die File fest. |
set | File | Legt den Namen der File fest. |
set | File | Ändert den Inhaber der File . |
set | File | Ändert den Inhaber der File . |
set | File | Legt fest, ob für den Zugriff auf die File ein Ressourcenschlüssel erforderlich ist, wenn sie über einen Link freigegeben wird. |
set | File | Hier legen Sie fest, ob Nutzer mit Bearbeitungsberechtigungen für die File die Inhalte für andere Nutzer freigeben oder die Berechtigungen ändern dürfen. |
set | File | Hier wird festgelegt, welche Nutzergruppe auf die File zugreifen kann und welche Berechtigungen diesen Nutzern gewährt werden, zusätzlich zu einzelnen Nutzern, die ausdrücklich Zugriff erhalten haben. |
set | File | Gibt an, ob die File im Drive des Nutzers mit einem Stern markiert ist. |
set | File | Gibt an, 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, mit dem diese Iteration zu einem späteren Zeitpunkt fortgesetzt werden kann. |
has | Boolean | Bestimmt, 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 | Der angegebene Nutzer wird der Liste der Mitbearbeiter für die Folder hinzugefügt. |
add | Folder | Der angegebene Nutzer wird der Liste der Mitbearbeiter für die Folder hinzugefügt. |
add | Folder | Fügt der Liste der Mitbearbeiter für die Folder das angegebene Nutzerarray hinzu. |
add | Folder | Der angegebene Nutzer wird der Liste der Zuschauer für die Folder hinzugefügt. |
add | Folder | Der angegebene Nutzer wird der Liste der Zuschauer für die Folder hinzugefügt. |
add | Folder | Fügen Sie der Liste der Zuschauer für die Folder das angegebene Array von Nutzern hinzu. |
create | File | Erstellt eine Datei im aktuellen Ordner aus einer angegebenen Blob mit beliebigen Daten. |
create | File | Erstellt eine Textdatei im aktuellen Ordner 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 einen Ordner im aktuellen 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 mit der angegebenen Drive-Element-ID und dem 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 | Das Datum, an dem die 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 dem aktuellen Ordner untergeordnet sind und den angegebenen Namen haben. |
get | File | Ruft eine Sammlung aller Dateien ab, die dem aktuellen Ordner untergeordnet sind und den angegebenen MIME-Typ haben. |
get | Folder | Eine Sammlung aller Ordner, die untergeordnete Elemente des aktuellen Ordners sind. |
get | Folder | Ruft eine Sammlung aller Ordner ab, die dem aktuellen Ordner untergeordnet sind und den angegebenen Namen haben. |
get | String | Ruft die ID der Folder ab. |
get | Date | Das Datum, an dem die Folder zuletzt aktualisiert wurde. |
get | String | Ruft den Namen der Folder ab. |
get | User | Ruft den Eigentümer dieser Folder ab. |
get | Folder | Eine Sammlung von Ordnern wird abgerufen, die unmittelbar übergeordnete Elemente von Folder sind. |
get | String | Ruft den Ressourcenschlüssel der Folder ab, der zum Zugriff auf Elemente erforderlich ist, die über einen Link freigegeben wurden. |
get | Boolean | Gibt an, ob für diese Folder das Sicherheitsupdate angewendet werden kann, für das ein Ressourcenschlüssel für den Zugriff erforderlich ist, wenn die Datei über einen Link freigegeben wird. |
get | Boolean | Gibt an, ob für diese Folder ein Ressourcenschlüssel für den Zugriff erforderlich ist, wenn sie über einen Link freigegeben wird. |
get | Access | Gibt an, welche Nutzergruppe neben einzelnen Nutzern, denen explizit Zugriff gewährt wurde, auf das Folder zugreifen kann. |
get | Permission | Ruft die Berechtigung ab, die den Nutzern gewährt wurde, die auf die Folder zugreifen können, sowie die Berechtigung einzelner Nutzer, denen explizit Zugriff gewährt wurde. |
get | Integer | Die Anzahl der Byte, die zum Speichern der Folder in Drive verwendet werden. |
get | String | Die URL, 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 Inhalte für andere Nutzer freigeben oder die Berechtigungen ändern dürfen. |
is | Boolean | Gibt an, ob die Folder im Drive des Nutzers mit einem Stern markiert wurde. |
is | Boolean | Bestimmt, ob sich die Folder im Papierkorb des Nutzers in Google Drive befindet. |
move | Folder | Verschiebt dieses Element in den angegebenen Zielordner. |
remove | Folder | Der angegebene Nutzer wird aus der Liste der Mitbearbeiter der Folder entfernt. |
remove | Folder | Der angegebene Nutzer wird aus der Liste der Mitbearbeiter der Folder entfernt. |
remove | Folder | Der angegebene Nutzer wird aus der Liste der Zuschauer und Kommentatoren für die Folder entfernt. |
remove | Folder | Der angegebene Nutzer wird aus der Liste der Zuschauer und Kommentatoren für die Folder entfernt. |
revoke | Folder | Hiermit wird der dem Nutzer gewährte Zugriff auf Folder widerrufen. |
revoke | Folder | Hiermit wird der dem Nutzer gewährte Zugriff auf Folder widerrufen. |
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 untergeordnet zum aktuellen Ordner sind und den angegebenen Suchkriterien entsprechen. |
set | Folder | Legt die Beschreibung für die Folder fest. |
set | Folder | Legt den Namen der Folder fest. |
set | Folder | Ändert den Inhaber der Folder . |
set | Folder | Ändert den Inhaber der Folder . |
set | Folder | Legt fest, ob für den Zugriff auf die Folder ein Ressourcenschlüssel erforderlich ist, wenn sie über einen Link freigegeben wird. |
set | Folder | Hier legen Sie fest, ob Nutzer mit Bearbeitungsberechtigungen für die Folder die Inhalte für andere Nutzer freigeben oder die Berechtigungen ändern dürfen. |
set | Folder | Hier wird festgelegt, welche Nutzergruppe auf die Folder zugreifen kann und welche Berechtigungen diesen Nutzern gewährt werden, zusätzlich zu einzelnen Nutzern, die ausdrücklich Zugriff erhalten haben. |
set | Folder | Gibt an, ob die Folder im Drive des Nutzers mit einem Stern markiert ist. |
set | Folder | Gibt an, 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, mit dem diese Iteration zu einem späteren Zeitpunkt fortgesetzt werden kann. |
has | Boolean | Bestimmt, 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 der 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 | Der Domainname, der mit dem Konto des Nutzers verknüpft ist. |
get | String | Ruft die E-Mail-Adresse des Nutzers ab. |
get | String | Der Name des Nutzers. |
get | String | Die URL für das Foto des Nutzers. |