Eine Datei in Google Drive. Über Drive
können Sie auf Dateien zugreifen oder Dateien erstellen.
// Trash every untitled spreadsheet that hasn't been updated in a week. const files = DriveApp.getFilesByName('Untitled spreadsheet'); while (files.hasNext()) { const file = files.next(); if (new Date() - file.getLastUpdated() > 7 * 24 * 60 * 60 * 1000) { file.setTrashed(true); } }
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 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 | 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 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 | Überschreibt den Inhalt der Datei mit einem bestimmten Ersatz. |
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. |
Detaillierte Dokumentation
add Commenter(emailAddress)
Fügen Sie den angegebenen Nutzer der Liste der Kommentatoren für die File
hinzu. Wenn der Nutzer bereits in der Liste der Zuschauer war, wird er durch diese Methode aus der Liste entfernt.
const files = DriveApp.getFilesByName('Test'); // Loops through the files while (files.hasNext()) { const file = files.next(); file.addCommenter('[email protected]'); }
Parameter
Name | Typ | Beschreibung |
---|---|---|
email | String | Die E-Mail-Adresse des Nutzers, den Sie hinzufügen möchten. |
Rückflug
File
– Dieses File
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive
add Commenter(user)
Fügen Sie den angegebenen Nutzer der Liste der Kommentatoren für die File
hinzu. Wenn der Nutzer bereits in der Liste der Zuschauer war, wird er durch diese Methode aus der Liste entfernt.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Adds the active user as a commenter. while (files.hasNext()) { const file = files.next(); file.addCommenter(Session.getActiveUser()); }
Parameter
Name | Typ | Beschreibung |
---|---|---|
user | User | Eine Darstellung des hinzuzufügenden Nutzers. |
Rückflug
File
– Dieses File
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive
add Commenters(emailAddresses)
Füge der Liste der Kommentatoren für die File
das angegebene Array von Nutzern hinzu. Wenn einer der Nutzer bereits in der Liste der Zuschauer stand, wird er durch diese Methode aus der Liste entfernt.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); while (files.hasNext()) { const file = files.next(); // TODO(developer): Replace '[email protected]' and // '[email protected]' with the email addresses to add as // commenters. const emails = [ '[email protected]', '[email protected]', ]; console.log(file.addCommenters(emails)); }
Parameter
Name | Typ | Beschreibung |
---|---|---|
email | String[] | Ein Array mit den E-Mail-Adressen der Nutzer, die hinzugefügt werden sollen. |
Rückflug
File
– Dieses File
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive
add Editor(emailAddress)
Der angegebene Nutzer wird der Liste der Mitbearbeiter für die File
hinzugefügt. Wenn der Nutzer bereits auf der Liste der Zuschauer stand, wird er durch diese Methode aus der Liste entfernt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
email | String | Die E-Mail-Adresse des Nutzers, den Sie hinzufügen möchten. |
Rückflug
File
– Dieses File
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive
add Editor(user)
Der angegebene Nutzer wird der Liste der Mitbearbeiter für die File
hinzugefügt. Wenn der Nutzer bereits auf der Liste der Zuschauer stand, wird er durch diese Methode aus der Liste entfernt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
user | User | Eine Darstellung des hinzuzufügenden Nutzers. |
Rückflug
File
– Dieses File
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive
add Editors(emailAddresses)
Fügt der Liste der Mitbearbeiter für die File
das angegebene Nutzerarray hinzu. Wenn sich einer der Nutzer bereits in der Liste der Zuschauer befand, wird er durch diese Methode aus der Liste entfernt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
email | String[] | Ein Array mit den E-Mail-Adressen der Nutzer, die hinzugefügt werden sollen. |
Rückflug
File
– Dieses File
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive
add Viewer(emailAddress)
Der angegebene Nutzer wird der Liste der Zuschauer für die File
hinzugefügt. Wenn der Nutzer bereits in der Liste der Mitbearbeiter aufgeführt war, hat diese Methode keine Auswirkungen.
Parameter
Name | Typ | Beschreibung |
---|---|---|
email | String | Die E-Mail-Adresse des Nutzers, den Sie hinzufügen möchten. |
Rückflug
File
– Dieses File
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive
add Viewer(user)
Der angegebene Nutzer wird der Liste der Zuschauer für die File
hinzugefügt. Wenn der Nutzer bereits in der Liste der Mitbearbeiter aufgeführt war, hat diese Methode keine Auswirkungen.
Parameter
Name | Typ | Beschreibung |
---|---|---|
user | User | Eine Darstellung des hinzuzufügenden Nutzers. |
Rückflug
File
– Dieses File
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive
add Viewers(emailAddresses)
Fügen Sie der Liste der Zuschauer für die File
das angegebene Array von Nutzern hinzu. Wenn einer der Nutzer bereits in der Liste der Mitbearbeiter aufgeführt war, hat diese Methode keine Auswirkungen auf ihn.
Parameter
Name | Typ | Beschreibung |
---|---|---|
email | String[] | Ein Array mit den E-Mail-Adressen der Nutzer, die hinzugefügt werden sollen. |
Rückflug
File
– Dieses File
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive
get Access(email)
Ruft die Berechtigung ab, die einem bestimmten Nutzer gewährt wurde. Die Methode unterstützt nicht die Rückgabe von Berechtigungen für eine Google-Gruppe oder von Berechtigungen, die über Google-Gruppen übernommen wurden.
Parameter
Name | Typ | Beschreibung |
---|---|---|
email | String | Die E-Mail-Adresse des Nutzers, dessen Berechtigungen geprüft werden sollen. Google Groups wird nicht unterstützt. |
Rückflug
Permission
: Die dem Nutzer gewährten Berechtigungen.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Access(user)
Ruft die Berechtigung ab, die einem bestimmten Nutzer gewährt wurde. Die Methode unterstützt nicht die Rückgabe von Berechtigungen für eine Google-Gruppe oder von Berechtigungen, die über Google-Gruppen übernommen wurden.
Parameter
Name | Typ | Beschreibung |
---|---|---|
user | User | Eine Darstellung des Nutzers, dessen Berechtigungen geprüft werden sollen. |
Rückflug
Permission
: Die dem Nutzer gewährten Berechtigungen.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get As(contentType)
Gibt die Daten in diesem Objekt als Blob zurück, der in den angegebenen Inhaltstyp konvertiert wurde. Bei dieser Methode wird dem Dateinamen die entsprechende Erweiterung hinzugefügt, z. B. „meinedatei.pdf“. Es wird jedoch davon ausgegangen, dass der Teil des Dateinamens, der auf den letzten Punkt (falls vorhanden) folgt, eine vorhandene Erweiterung ist, die ersetzt werden soll. Daraus wird „Einkaufsliste.25.12.2014“ zu „Einkaufsliste.25.12.pdf“.
Die täglichen Kontingente für Conversions finden Sie unter Kontingente für Google-Dienste. Für neu erstellte Google Workspace-Domains gelten möglicherweise vorübergehend strengere Kontingente.
Parameter
Name | Typ | Beschreibung |
---|---|---|
content | String | Der MIME-Typ, in den konvertiert werden soll. Für die meisten Blobs ist 'application/pdf' die einzige gültige Option. Bei Bildern im BMP-, GIF-, JPEG- oder PNG-Format sind auch 'image/bmp' , 'image/gif' , 'image/jpeg' oder 'image/png' zulässig. Für ein Google Docs-Dokument ist auch 'text/markdown' zulässig. |
Rückflug
Blob
– die Daten als Blob.
get Blob()
get Date Created()
Das Datum, an dem die File
erstellt wurde.
Rückflug
Date
– das Datum, an dem die File
erstellt wurde
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Description()
Ruft die Beschreibung für die File
ab.
Rückflug
String
: Beschreibung der File
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Download Url()
Ruft die URL ab, über die die Datei heruntergeladen werden kann. Nur Nutzer, die berechtigt sind, die Datei in Google Drive zu öffnen, können auf die URL zugreifen. Sie können diese URL in einem Browser verwenden, um die Datei herunterzuladen, aber nicht, um sie mit Url
abzurufen. Wenn der Inhalt der Datei im Script verwendet werden soll, verwenden Sie get
.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files and logs the download URLs to the console. while (files.hasNext()) { const file = files.next(); console.log(file.getDownloadUrl()); }
Rückflug
String
: Die URL, über die die Datei heruntergeladen werden kann.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Editors()
Ruft die Liste der Mitbearbeiter für diese File
ab. Wenn der Nutzer, der das Script ausführt, keinen Bearbeitungszugriff auf die File
hat, gibt diese Methode ein leeres Array zurück.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Adds the email addresses in the array as editors of each file. // TODO(developer): Replace '[email protected]' // and '[email protected]' with valid email addresses. file.addEditors([ '[email protected]', '[email protected]', ]); // Gets a list of the file editors. const editors = file.getEditors(); // For each file, logs the editors' email addresses to the console. for (const editor of editors) { console.log(editor.getEmail()); } }
Rückflug
User[]
: Wenn der Nutzer Bearbeitungszugriff für diese File
hat, wird die Liste der Bearbeiter zurückgegeben. Wenn der Nutzer keinen Bearbeitungszugriff hat, wird ein leeres Array zurückgegeben.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Id()
Ruft die ID der File
ab.
Rückflug
String
: die ID des File
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Last Updated()
Das Datum, an dem die File
zuletzt aktualisiert wurde.
Rückflug
Date
– das Datum, an dem die File
zuletzt aktualisiert wurde
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Mime Type()
Ruft den MIME-Typ der Datei ab.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files and logs the MIME type to the console. while (files.hasNext()) { const file = files.next(); console.log(file.getMimeType()); }
Rückflug
String
: Der MIME-Typ der Datei.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Name()
Ruft den Namen der File
ab.
Rückflug
String
– der Name der File
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Owner()
Ruft den Eigentümer der Datei ab.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files and logs the names of the file owners to the console. while (files.hasNext()) { const file = files.next(); console.log(file.getOwner().getName()); }
Rückflug
User
: Der Dateieigentümer.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Parents()
Eine Sammlung von Ordnern wird abgerufen, die unmittelbar übergeordnete Elemente von File
sind.
Rückflug
Folder
: Eine Sammlung von Ordnern, die unmittelbar übergeordnete Ordner des File
sind
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Resource Key()
Ruft den Ressourcenschlüssel der File
ab, der zum Zugriff auf Elemente erforderlich ist, die über einen Link freigegeben wurden.
Rückflug
String
: Der Ressourcenschlüssel der File
.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Security Update Eligible()
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.
Für den Zugriff auf einige Dateien oder Ordner, die über einen Link freigegeben wurden, ist in Google Drive ein Ressourcenschlüssel erforderlich. Diese Änderung ist Teil eines Sicherheitsupdates. Die Funktion ist für berechtigte Dateien und Ordner standardmäßig aktiviert. Mit set
können Sie die Anforderung für Ressourcenschlüssel für berechtigte Dateien aktivieren oder deaktivieren.
Weitere Informationen zum Sicherheitsupdate für Google Drive
Rückflug
Boolean
: Gibt an, ob die Anforderung für den Ressourcenschlüssel auf die File
angewendet werden kann.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Security Update Enabled()
Gibt an, ob für diese File
ein Ressourcenschlüssel für den Zugriff erforderlich ist, wenn sie über einen Link freigegeben wird. Diese Anforderung ist für berechtigte Dateien und Ordner standardmäßig aktiviert.
Mit
setSecurityUpdateEnabled
können Sie die Anforderung für Ressourcenschlüssel für berechtigte Dateien aktivieren oder deaktivieren.
Weitere Informationen zum Sicherheitsupdate für Google Drive
Rückflug
Boolean
: Gibt an, ob die Anforderung für den Ressourcenschlüssel für diese File
aktiviert ist.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Sharing Access()
Gibt an, welche Nutzergruppe neben einzelnen Nutzern, denen explizit Zugriff gewährt wurde, auf das File
zugreifen kann.
Rückflug
Access
– die Nutzergruppe, die auf die File
zugreifen kann
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Sharing Permission()
Ruft die Berechtigung ab, die Nutzern gewährt wurde, die auf die File
zugreifen können, sowie die Berechtigung einzelner Nutzer, denen explizit Zugriff gewährt wurde.
Rückflug
Permission
: Berechtigungen, die Nutzern gewährt werden, die auf die File
zugreifen können
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Size()
Die Anzahl der Byte, die zum Speichern der File
in Drive verwendet werden. Google Workspace-Anwendungsdateien werden nicht auf die Speicherlimits von Google Drive angerechnet und es werden daher 0
Byte zurückgegeben.
Rückflug
Integer
– die Anzahl der Byte, die zum Speichern der File
in Drive verwendet werden
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Target Id()
Wenn es sich um einen Verknüpfung handelt, wird die ID des Elements zurückgegeben, auf das sie verweist.
Andernfalls wird null
zurückgegeben.
// The ID of the file for which to make a shortcut and the ID of // the folder to which you want to add the shortcut. // TODO(developer): Replace the file and folder IDs with your IDs. const fileId = 'abc123456'; const folderId = 'xyz987654'; // Gets the folder to add the shortcut to. const folder = DriveApp.getFolderById(folderId); // Creates a shortcut of the file and moves it to the specified folder. const shortcut = DriveApp.createShortcut(fileId).moveTo(folder); // Logs the target ID of the shortcut. console.log(`${shortcut.getName()}=${shortcut.getTargetId()}`);
Rückflug
String
: Die ID des Zielartikels.
get Target Mime Type()
Wenn es sich um einen Verknüpfung handelt, wird der MIME-Typ des Elements zurückgegeben, auf das sie verweist.
Andernfalls wird null
zurückgegeben.
// The ID of the file for which to make a shortcut and the ID of // the folder to which you want to add the shortcut. // TODO(developer): Replace the file and folder IDs with your IDs. const fileId = 'abc123456'; const folderId = 'xyz987654'; // Gets the folder to add the shortcut to. const folder = DriveApp.getFolderById(folderId); // Creates a shortcut of the file and moves it to the specified folder. const shortcut = DriveApp.createShortcut(fileId).moveTo(folder); // Logs the MIME type of the file that the shortcut points to. console.log(`MIME type of the shortcut: ${shortcut.getTargetMimeType()}`);
Rückflug
String
: Der MIME-Typ des Zielelements.
get Target Resource Key()
Wenn es sich bei der Datei um einen Verknüpfung handelt, wird der Ressourcenschlüssel des Elements zurückgegeben, auf das sie verweist. Ein Ressourcenschlüssel ist ein zusätzlicher Parameter, den Sie übergeben müssen, um auf Dateien zuzugreifen, die über einen Link freigegeben wurden.
Wenn die Datei kein Verknüpfung ist, wird null
zurückgegeben.
// Gets a file by its ID. // TODO(developer): Replace 'abc123456' with your file ID. const file = DriveApp.getFileById('abc123456'); // If the file is a shortcut, returns the resource key of the file that it // points to. console.log(file.getTargetResourceKey());
Rückflug
String
: Der Ressourcenschlüssel des Zielelements oder null
, wenn es sich bei der Datei nicht um eine Verknüpfung handelt.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Thumbnail()
Hier wird ein Thumbnail-Bild für die Datei abgerufen oder null
, wenn kein Thumbnail vorhanden ist.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Logs the thumbnail image for each file to the console as a blob, // or null if no thumbnail exists. console.log(file.getThumbnail()); }
Rückflug
Blob
: Das Thumbnail der Datei.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Url()
Ruft die URL ab, mit der die File
in einer Google-App wie Drive oder Docs geöffnet werden kann.
Rückflug
String
: Die URL, über die diese File
in einer Google-App wie Drive oder Docs angezeigt werden kann
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Viewers()
Ruft die Liste der Betrachter und Kommentatoren für diese File
ab. Wenn der Nutzer, der das Script ausführt, keinen Bearbeitungszugriff auf File
hat, gibt diese Methode ein leeres Array zurück.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // For each file, logs the viewers' email addresses to the console. const viewers = file.getViewers(); for (const viewer of viewers) { console.log(viewer.getEmail()); } }
Rückflug
User[]
: Wenn der Nutzer Bearbeitungszugriff für diese File
hat, wird die Liste der Betrachter und Kommentatoren zurückgegeben. Wenn der Nutzer keinen Bearbeitungszugriff hat, wird ein leeres Array zurückgegeben.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
is Starred()
Gibt an, ob die File
im Drive des Nutzers mit einem Stern markiert wurde.
Rückflug
Boolean
– true
, wenn die File
in Google Drive mit einem Stern markiert ist; false
andernfalls
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
is Trashed()
Bestimmt, ob sich die File
im Papierkorb des Nutzers in Google Drive befindet.
Rückflug
Boolean
– true
, wenn sich die File
im Papierkorb des Nutzers in Google Drive befindet;
false
, wenn nicht
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
make Copy()
Erstellt eine Kopie der Datei.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Creates a copy of each file and logs the file name to the console. console.log(file.makeCopy().getName()); }
Rückflug
File
– die neue Kopie.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive
make Copy(destination)
Erstellt eine Kopie der Datei im Zielverzeichnis.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Creates a copy of each file and adds it to the specified folder. // TODO(developer): Replace the folder ID with your own. const destination = DriveApp.getFolderById('123456abcxyz'); const copiedFile = file.makeCopy(destination); // Logs the file names to the console. console.log(copiedFile.getName()); }
Parameter
Name | Typ | Beschreibung |
---|---|---|
destination | Folder | Das Verzeichnis, in das die Datei kopiert werden soll. |
Rückflug
File
– die neue Kopie.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive
make Copy(name)
Erstellt eine Kopie der Datei und benennt sie mit dem angegebenen Namen.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Creates a copy of each file and sets the name to 'Test-Copy.' const filename = file.makeCopy('Test-Copy'); // Logs the copied file's name to the console. console.log(filename.getName()); }
Parameter
Name | Typ | Beschreibung |
---|---|---|
name | String | Der Dateiname, der auf die neue Kopie angewendet werden soll. |
Rückflug
File
– die neue Kopie.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive
make Copy(name, destination)
Erstellt eine Kopie der Datei im Zielverzeichnis und benennt sie mit dem angegebenen Namen.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Creates a copy of each file, sets the file name, and adds the copied file // to the specified folder. // TODO(developer): Replace the folder ID with your own. const destination = DriveApp.getFolderById('123456abcxyz'); const copiedFile = file.makeCopy('Test-Copy', destination); // Logs the file names to the console. console.log(copiedFile.getName()); }
Parameter
Name | Typ | Beschreibung |
---|---|---|
name | String | Der Dateiname, der auf die neue Kopie angewendet werden soll. |
destination | Folder | Das Verzeichnis, in das die Datei kopiert werden soll. |
Rückflug
File
– die neue Kopie.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive
move To(destination)
Verschiebt dieses Element in den angegebenen Zielordner.
Der aktuelle Nutzer muss der Eigentümer der Datei sein oder mindestens Bearbeitungszugriff auf den aktuellen übergeordneten Ordner des Elements haben, um das Element in den Zielordner zu verschieben.
Parameter
Name | Typ | Beschreibung |
---|---|---|
destination | Folder | Der Ordner, der das neue übergeordnete Element wird. |
Rückflug
File
– Dieses File
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive
remove Commenter(emailAddress)
Der angegebene Nutzer wird aus der Liste der Kommentatoren für die File
entfernt. Bei dieser Methode wird der Zugriff auf die File
nicht für Nutzer blockiert, die zu einer Gruppe von Nutzern mit allgemeinem Zugriff gehören, z. B. wenn die File
für die gesamte Domain des Nutzers freigegeben ist.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Removes the given user from the list of commenters for each file. // TODO(developer): Replace the email with the email of the user you want to // remove. file.removeCommenter('[email protected]'); }
Parameter
Name | Typ | Beschreibung |
---|---|---|
email | String | Die E-Mail-Adresse des Nutzers, der entfernt werden soll. |
Rückflug
File
– Dieses File
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive
remove Commenter(user)
Der angegebene Nutzer wird aus der Liste der Kommentatoren für die File
entfernt. Bei dieser Methode wird der Zugriff auf die File
nicht für Nutzer blockiert, die zu einer Gruppe von Nutzern mit allgemeinem Zugriff gehören, z. B. wenn die File
für die gesamte Domain des Nutzers freigegeben ist.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Removes the given user from the list of commenters for each file. console.log(file.removeCommenter(Session.getActiveUser())); }
Parameter
Name | Typ | Beschreibung |
---|---|---|
user | User | Eine Darstellung des zu entfernenden Nutzers. |
Rückflug
File
– Dieses File
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive
remove Editor(emailAddress)
Der angegebene Nutzer wird aus der Liste der Mitbearbeiter der File
entfernt. Mit dieser Methode wird der Zugriff von Nutzern auf die File
nicht blockiert, wenn sie zu einer Gruppe von Nutzern mit allgemeinem Zugriff gehören. Das ist beispielsweise der Fall, wenn die File
für die gesamte Domain des Nutzers freigegeben wurde oder sich die File
in einer geteilten Ablage befindet, auf die der Nutzer zugreifen kann.
Bei Drive-Dateien wird der Nutzer dadurch auch aus der Liste der Betrachter entfernt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
email | String | Die E-Mail-Adresse des Nutzers, der entfernt werden soll. |
Rückflug
File
– Dieses File
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive
remove Editor(user)
Der angegebene Nutzer wird aus der Liste der Mitbearbeiter der File
entfernt. Mit dieser Methode wird der Zugriff von Nutzern auf die File
nicht blockiert, wenn sie zu einer Gruppe von Nutzern mit allgemeinem Zugriff gehören. Das ist beispielsweise der Fall, wenn die File
für die gesamte Domain des Nutzers freigegeben wurde oder sich die File
in einer geteilten Ablage befindet, auf die der Nutzer zugreifen kann.
Bei Drive-Dateien wird der Nutzer dadurch auch aus der Liste der Betrachter entfernt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
user | User | Eine Darstellung des zu entfernenden Nutzers. |
Rückflug
File
– Dieses File
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive
remove Viewer(emailAddress)
Der angegebene Nutzer wird aus der Liste der Zuschauer und Kommentatoren für die File
entfernt. Diese Methode hat keine Auswirkungen, wenn der Nutzer ein Mitbearbeiter und kein Betrachter oder Kommentator ist. Außerdem wird mit dieser Methode der Zugriff von Nutzern auf die File
nicht blockiert, wenn sie zu einer Gruppe von Nutzern mit allgemeinem Zugriff gehören. Das ist beispielsweise der Fall, wenn die File
für die gesamte Domain des Nutzers freigegeben wurde oder sich die File
in einer geteilten Ablage befindet, auf die der Nutzer zugreifen kann.File
Bei Drive-Dateien wird der Nutzer auch aus der Liste der Mitbearbeiter entfernt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
email | String | Die E-Mail-Adresse des Nutzers, der entfernt werden soll. |
Rückflug
File
– Dieses File
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive
remove Viewer(user)
Der angegebene Nutzer wird aus der Liste der Zuschauer und Kommentatoren für die File
entfernt. Diese Methode hat keine Auswirkungen, wenn der Nutzer ein Mitbearbeiter und kein Betrachter ist. Außerdem wird mit dieser Methode der Zugriff von Nutzern auf die File
nicht blockiert, wenn sie zu einer Gruppe von Nutzern mit allgemeinem Zugriff gehören. Das ist beispielsweise der Fall, wenn die File
für die gesamte Domain des Nutzers freigegeben ist oder sich die File
in einer geteilten Ablage befindet, auf die der Nutzer zugreifen kann.
Bei Drive-Dateien wird der Nutzer auch aus der Liste der Mitbearbeiter entfernt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
user | User | Eine Darstellung des zu entfernenden Nutzers. |
Rückflug
File
– Dieses File
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive
revoke Permissions(emailAddress)
Hiermit wird der dem Nutzer gewährte Zugriff auf File
widerrufen. Bei dieser Methode wird der Zugriff auf die File
nicht blockiert, wenn Nutzer zu einer Gruppe von Nutzern mit allgemeinem Zugriff gehören, z. B. wenn die File
für die gesamte Domain des Nutzers freigegeben wurde.
Parameter
Name | Typ | Beschreibung |
---|---|---|
email | String | Die E-Mail-Adresse des Nutzers, dessen Zugriff widerrufen werden soll. |
Rückflug
File
– Dieses File
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive
revoke Permissions(user)
Hiermit wird der dem Nutzer gewährte Zugriff auf File
widerrufen. Bei dieser Methode wird der Zugriff auf die File
nicht blockiert, wenn Nutzer zu einer Gruppe von Nutzern mit allgemeinem Zugriff gehören, z. B. wenn die File
für die gesamte Domain des Nutzers freigegeben wurde.
Parameter
Name | Typ | Beschreibung |
---|---|---|
user | User | Eine Darstellung des Nutzers, dessen Zugriff widerrufen werden soll. |
Rückflug
File
– Dieses File
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive
set Content(content)
Überschreibt den Inhalt der Datei mit einem bestimmten Ersatz. Es wird eine Ausnahme ausgelöst, wenn content
größer als 10 MB ist.
// Creates a text file with the content 'Hello, world!' const file = DriveApp.createFile('New Text File', 'Hello, world!'); // Logs the content of the text file to the console. console.log(file.getBlob().getDataAsString()); // Updates the content of the text file to 'Updated text!' file.setContent('Updated text!'); // Logs content of the text file to the console. console.log(file.getBlob().getDataAsString());
Parameter
Name | Typ | Beschreibung |
---|---|---|
content | String | Der neue Inhalt der Datei. |
Rückflug
File
– Dieses File
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive
set Description(description)
Legt die Beschreibung für die File
fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
description | String | die neue Beschreibung für die File |
Rückflug
File
– dieses File
für die Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive
set Name(name)
Legt den Namen der File
fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
name | String | den neuen Namen der File |
Rückflug
File
– dieses File
für die Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive
set Owner(emailAddress)
Ändert den Inhaber der File
. Mit dieser Methode erhält der bisherige Inhaber auch ausdrücklichen Bearbeitungszugriff auf die File
.
Parameter
Name | Typ | Beschreibung |
---|---|---|
email | String | die E-Mail-Adresse des Nutzers, der der neue Inhaber werden soll |
Rückflug
File
– dieses File
für die Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive
set Owner(user)
Ändert den Inhaber der File
. Mit dieser Methode erhält der bisherige Inhaber auch ausdrücklichen Bearbeitungszugriff auf die File
.
Parameter
Name | Typ | Beschreibung |
---|---|---|
user | User | eine Darstellung des Nutzers, der der neue Inhaber werden soll |
Rückflug
File
– dieses File
für die Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive
set Security Update Enabled(enabled)
Legt fest, ob für den Zugriff auf die File
ein Ressourcenschlüssel erforderlich ist, wenn sie über einen Link freigegeben wird. Geeignete Dateien und Ordner sind standardmäßig aktiviert.
Weitere Informationen zum Sicherheitsupdate für Google Drive
Parameter
Name | Typ | Beschreibung |
---|---|---|
enabled | Boolean | Ob die Anforderung für den Ressourcenschlüssel für die File aktiviert werden soll. |
Rückflug
File
– Dieses File
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive
set Sharing(accessType, permissionType)
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.
// Creates a folder that anyone on the Internet can read from and write to. // (Domain administrators can prohibit this setting for users of a Google // Workspace domain.) const folder = DriveApp.createFolder('Shared Folder'); folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);
Parameter
Name | Typ | Beschreibung |
---|---|---|
access | Access | Welche Nutzergruppe sollte auf die File |
permission | Permission | die Berechtigungen, die Nutzern gewährt werden sollen, die auf die File zugreifen können |
Rückflug
File
– dieses File
für die Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive
set Starred(starred)
Gibt an, ob die File
im Drive des Nutzers mit einem Stern markiert ist. Der Standardwert für neue File
s ist false
.
Parameter
Name | Typ | Beschreibung |
---|---|---|
starred | Boolean | true , wenn die File in Google Drive des Nutzers mit einem Stern markiert werden soll; false andernfalls |
Rückflug
File
– dieses File
für die Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive
set Trashed(trashed)
Gibt an, ob sich die File
im Papierkorb des Drive-Kontos des Nutzers befindet. Nur der Eigentümer kann die File
in den Papierkorb verschieben. Der Standardwert für neue File
s ist false
.
Parameter
Name | Typ | Beschreibung |
---|---|---|
trashed | Boolean | true , wenn die File in den Papierkorb des Drive-Kontos des Nutzers verschoben werden soll, false andernfalls |
Rückflug
File
– dieses File
für die Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/drive