Class File

Datei

Eine Datei in Google Drive Sie können über DriveApp auf die Dateien zugreifen oder sie erstellen.

// Trash every untitled spreadsheet that hasn't been updated in a week.
var files = DriveApp.getFilesByName('Untitled spreadsheet');
while (files.hasNext()) {
  var file = files.next();
  if (new Date() - file.getLastUpdated() > 7 * 24 * 60 * 60 * 1000) {
    file.setTrashed(true);
  }
}

Methoden

MethodeRückgabetypKurzbeschreibung
addCommenter(emailAddress)FileFügen Sie den angegebenen Nutzer der Liste der Kommentatoren für File hinzu.
addCommenter(user)FileFügen Sie den angegebenen Nutzer der Liste der Kommentatoren für File hinzu.
addCommenters(emailAddresses)FileFüge 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 File hinzu.
addViewer(user)FileFügt den angegebenen Nutzer der Liste der Betrachter für File hinzu.
addViewers(emailAddresses)FileFügt das angegebene Array von Nutzern der Liste der Betrachter 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 File erstellt wurde.
getDescription()StringRuft die Beschreibung für File ab.
getDownloadUrl()StringRuft die URL ab, über die die Datei heruntergeladen werden kann.
getEditors()User[]Ruft die Liste der Bearbeiter für diesen File ab.
getId()StringRuft die ID von File ab.
getLastUpdated()DateRuft das Datum ab, an dem 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 File unmittelbar übergeordnet sind.
getResourceKey()StringRuft den Ressourcenschlüssel von File ab, der für den Zugriff auf Elemente erforderlich ist, die über einen Link freigegeben wurden.
getSecurityUpdateEligible()BooleanRuft ab, ob dieser File berechtigt ist, das Sicherheitsupdate anzuwenden, das einen Ressourcenschlüssel für den Zugriff erfordert, wenn es über einen Link freigegeben wird.
getSecurityUpdateEnabled()BooleanRuft ab, ob für diesen File ein Ressourcenschlüssel für den Zugriff erforderlich ist, wenn er über einen Link freigegeben wird.
getSharingAccess()AccessRuft ab, welche Klasse von Nutzern auf File zugreifen kann, ausgenommen einzelne Nutzer, denen explizit Zugriff gewährt wurde.
getSharingPermission()PermissionRuft die Berechtigung für die Nutzer ab, die auf File zugreifen können, ausgenommen einzelne Nutzer, denen explizit Zugriff gewährt wurde.
getSize()IntegerRuft die Anzahl der Byte ab, die zum Speichern von File in Drive verwendet werden.
getTargetId()StringBei einer Verknüpfung wird die ID des Elements zurückgegeben, auf das sie verweist.
getTargetMimeType()StringWenn es sich um einen Shortcut handelt, 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, mit der File in einer Google-App wie Drive oder Docs geöffnet werden kann.
getViewers()User[]Liste der Betrachter und Kommentatoren für diesen File abrufen
isShareableByEditors()BooleanBestimmt, ob Nutzer mit Bearbeitungsberechtigungen für File Dateien für andere Nutzer freigeben oder die Berechtigungen ändern dürfen.
isStarred()BooleanErmittelt, ob File in der Ablage des Nutzers markiert wurde.
isTrashed()BooleanLegt fest, ob sich das File-Element im Papierkorb des Nutzers in 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 einen Namen.
makeCopy(name, destination)FileErstellt im Zielverzeichnis eine Kopie der Datei und gibt ihr einen Namen.
moveTo(destination)FileVerschiebt dieses Element in den angegebenen Zielordner.
removeCommenter(emailAddress)FileEntfernt den angegebenen Nutzer aus der Liste der Kommentatoren für File.
removeCommenter(user)FileEntfernt den angegebenen Nutzer aus der Liste der Kommentatoren für 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 File.
removeViewer(user)FileEntfernt den angegebenen Nutzer aus der Liste der Betrachter und Kommentatoren für File.
revokePermissions(emailAddress)FileHebt den Zugriff auf die File auf, die dem jeweiligen Nutzer gewährt wurden.
revokePermissions(user)FileHebt den Zugriff auf die File auf, die dem jeweiligen Nutzer gewährt wurden.
setContent(content)FileÜberschreibt den Inhalt der Datei mit einem bestimmten Ersatz.
setDescription(description)FileLegt die Beschreibung für File fest.
setName(name)FileLegt den Namen von File fest.
setOwner(emailAddress)FileEigentümer von File ändern
setOwner(user)FileEigentümer von File ändern
setSecurityUpdateEnabled(enabled)FileLegt fest, ob das File für den Zugriff einen Ressourcenschlüssel erfordert, wenn es über einen Link freigegeben wird.
setShareableByEditors(shareable)FileLegt fest, ob Nutzer mit Bearbeitungsberechtigungen für File Dateien für andere Nutzer freigeben oder die Berechtigungen ändern dürfen.
setSharing(accessType, permissionType)FileLegt fest, welche Klasse von Nutzern auf File zugreifen kann und welche Berechtigungen diesen Nutzern gewährt werden, abgesehen von einzelnen Nutzern, denen explizit Zugriff gewährt wurde.
setStarred(starred)FileLegt fest, ob das File in der Ablage des Nutzers markiert ist.
setTrashed(trashed)FileLegt fest, ob sich das File-Element im Papierkorb des Nutzers in der Ablage des Nutzers befindet.

Detaillierte Dokumentation

addCommenter(emailAddress)

Fügen Sie den angegebenen Nutzer der Liste der Kommentatoren für File hinzu. Wenn sich der Nutzer bereits in der Liste der Betrachter befand, wird er mit dieser Methode aus der Liste der Betrachter herausgestuft.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace 'cloudysanfrancisco@gmail.com' with the email address that you
// want to add as a commenter.
while (files.hasNext()) {
  const file = files.next();
  email = 'cloudysanfrancisco@gmail.com';
  console.log(file.addCommenter(email));
}

Parameter

NameTypBeschreibung
emailAddressStringDie E-Mail-Adresse des Nutzers, der hinzugefügt werden soll.

Return

File: Dieses File für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

addCommenter(user)

Fügen Sie den angegebenen Nutzer der Liste der Kommentatoren für File hinzu. Wenn sich der Nutzer bereits in der Liste der Betrachter befand, wird er mit dieser Methode aus der Liste der Betrachter herausgestuft.

// 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

NameTypBeschreibung
userUserEine Darstellung des hinzuzufügenden Nutzers.

Return

File: Dieses File für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

addCommenters(emailAddresses)

Füge das angegebene Array von Nutzern der Liste der Kommentatoren für File hinzu. Wenn einer der Nutzer bereits in der Liste der Nutzer enthalten war, wird er mit dieser Methode aus der Liste der Betrachter herausgestuft.

// 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 'cloudysanfrancisco@gmail.com' and
  // 'baklavainthebalkans@gmail.com' with the email addresses to add as commenters.
  const emails = ['cloudysanfrancisco@gmail.com','baklavainthebalkans@gmail.com'];
  console.log(file.addCommenters(emails));
}

Parameter

NameTypBeschreibung
emailAddressesString[]Ein Array mit E-Mail-Adressen der hinzuzufügenden Nutzer.

Return

File: Dieses File für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

addEditor(emailAddress)

Fügt den angegebenen Nutzer der Liste der Bearbeiter für File hinzu. Wenn der Nutzer bereits in der Liste der Betrachter enthalten war, wird er mit dieser Methode aus der Liste der Betrachter herausgestuft.

Parameter

NameTypBeschreibung
emailAddressStringDie E-Mail-Adresse des Nutzers, der hinzugefügt werden soll.

Return

File: Dieses File für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

addEditor(user)

Fügt den angegebenen Nutzer der Liste der Bearbeiter für File hinzu. Wenn der Nutzer bereits in der Liste der Betrachter enthalten war, wird er mit dieser Methode aus der Liste der Betrachter herausgestuft.

Parameter

NameTypBeschreibung
userUserEine Darstellung des hinzuzufügenden Nutzers.

Return

File: Dieses File für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

addEditors(emailAddresses)

Fügt das angegebene Array von Nutzern der Liste der Bearbeiter für File hinzu. Wenn einer der Nutzer bereits in der Liste der Betrachter enthalten war, wird er mit dieser Methode aus der Liste der Betrachter herausgestuft.

Parameter

NameTypBeschreibung
emailAddressesString[]Ein Array mit E-Mail-Adressen der hinzuzufügenden Nutzer.

Return

File: Dieses File für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

addViewer(emailAddress)

Fügt den angegebenen Nutzer der Liste der Betrachter für File hinzu. Wenn sich der Nutzer bereits in der Liste der Bearbeiter befand, hat diese Methode keine Auswirkungen.

Parameter

NameTypBeschreibung
emailAddressStringDie E-Mail-Adresse des Nutzers, der hinzugefügt werden soll.

Return

File: Dieses File für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

addViewer(user)

Fügt den angegebenen Nutzer der Liste der Betrachter für File hinzu. Wenn sich der Nutzer bereits in der Liste der Bearbeiter befand, hat diese Methode keine Auswirkungen.

Parameter

NameTypBeschreibung
userUserEine Darstellung des hinzuzufügenden Nutzers.

Return

File: Dieses File für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

addViewers(emailAddresses)

Fügt das angegebene Array von Nutzern der Liste der Betrachter für File hinzu. Wenn sich Nutzer bereits in der Liste der Bearbeiter befanden, hat diese Methode keine Auswirkungen auf sie.

Parameter

NameTypBeschreibung
emailAddressesString[]Ein Array mit E-Mail-Adressen der hinzuzufügenden Nutzer.

Return

File: Dieses File für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

getAccess(email)

Ruft die Berechtigung ab, die dem angegebenen Nutzer gewährt wurde.

Parameter

NameTypBeschreibung
emailStringDie E-Mail-Adresse des Nutzers, dessen Berechtigungen überprüft werden sollen

Return

Permission: dem Nutzer gewährte Berechtigungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getAccess(user)

Ruft die Berechtigung ab, die dem angegebenen Nutzer gewährt wurde.

Parameter

NameTypBeschreibung
userUserDarstellung des Nutzers, dessen Berechtigungen überprüft werden sollen

Return

Permission: dem Nutzer gewährte Berechtigungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getAs(contentType)

Gibt die Daten in diesem Objekt als Blob zurück, das in den angegebenen Inhaltstyp konvertiert wurde. Bei dieser Methode wird dem Dateinamen die entsprechende Erweiterung hinzugefügt, z. B. "myfile.pdf". Dabei wird jedoch davon ausgegangen, dass der Teil des Dateinamens, der auf den letzten Punkt (falls vorhanden) folgt, eine vorhandene Erweiterung ist, die ersetzt werden sollte. Aus „ShoppingList.12.25.2014“ wird dann „ShoppingList.12.25.pdf“.

Informationen zu den Tageskontingenten 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

NameTypBeschreibung
contentTypeStringDer MIME-Typ, in den konvertiert werden soll. Für die meisten Blobs ist 'application/pdf' die einzige gültige Option. Für Bilder im BMP-, GIF-, JPEG- oder PNG-Format sind auch 'image/bmp', 'image/gif', 'image/jpeg' oder 'image/png' gültig.

Return

Blob: Die Daten als Blob.


getBlob()

Gibt die Daten in diesem Objekt als Blob zurück.

Return

Blob: Die Daten als Blob.


getDateCreated()

Ruft das Datum ab, an dem File erstellt wurde.

Return

Date: Das Datum, an dem die File erstellt wurde

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getDescription()

Ruft die Beschreibung für File ab.

Return

String – die Beschreibung für File

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getDownloadUrl()

Ruft die URL ab, über die die Datei heruntergeladen werden kann. Nur Nutzer mit der Berechtigung zum Öffnen der Datei in Google Drive haben Zugriff auf die URL. Sie können diese URL in einem Browser verwenden, um die Datei herunterzuladen. Sie können sie jedoch nicht zum Abrufen der Datei mit UrlFetchApp verwenden. Wenn Sie den Inhalt der Datei im Skript abrufen möchten, verwenden Sie getBlob().

// 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());
}

Return

String: Die URL, über die die Datei heruntergeladen werden kann.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getEditors()

Ruft die Liste der Bearbeiter für diesen File ab. Wenn der Nutzer, der das Skript 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();

  // Adds the email addresses in the array as editors of each file.
  // TODO(developer): Replace 'cloudysanfrancisco@gmail.com'
  // and 'baklavainthebalkans@gmail.com' with valid email addresses.
  file.addEditors(['cloudysanfrancisco@gmail.com', 'baklavainthebalkans@gmail.com']);

  // 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());
  }
}

Return

User[]: Wenn der Nutzer Bearbeitungszugriff auf diese File hat, wird die Liste der Bearbeiter zurückgegeben. Wenn der Nutzer keinen Bearbeitungszugriff hat, wird ein leeres Array zurückgegeben.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getId()

Ruft die ID von File ab.

Return

String: die ID von File

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getLastUpdated()

Ruft das Datum ab, an dem File zuletzt aktualisiert wurde.

Return

Date: Das Datum, an dem die File zuletzt aktualisiert wurde

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getMimeType()

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());
}

Return

String: Der MIME-Typ der Datei.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getName()

Ruft den Namen des File ab.

Return

String: der Name von File

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getOwner()

Ruft den Dateieigentümer 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());
}

Return

User: Dateieigentümer

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getParents()

Ruft eine Sammlung von Ordnern ab, die File unmittelbar übergeordnet sind.

Return

FolderIterator: eine Sammlung von Ordnern, die File unmittelbar übergeordnet sind

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getResourceKey()

Ruft den Ressourcenschlüssel von File ab, der für den Zugriff auf Elemente erforderlich ist, die über einen Link freigegeben wurden.

Return

String: Der Ressourcenschlüssel von File.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getSecurityUpdateEligible()

Ruft ab, ob dieser File berechtigt ist, das Sicherheitsupdate anzuwenden, das einen Ressourcenschlüssel für den Zugriff erfordert, wenn es über einen Link freigegeben wird.

Drive benötigt einen Ressourcenschlüssel für den Zugriff auf einige Dateien oder Ordner, die über einen Link freigegeben wurden. Diese Änderung ist Teil eines Sicherheitsupdates. Das Update ist für zulässige Dateien und Ordner standardmäßig aktiviert. Verwenden Sie setSecurityUpdateEnabled, um die Ressourcenschlüsselanforderung für zulässige Dateien zu aktivieren oder zu deaktivieren.

Weitere Informationen zum Sicherheitsupdate für Google Drive

Return

Boolean: Gibt an, ob die Ressourcenschlüsselanforderung für File angewendet werden kann.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getSecurityUpdateEnabled()

Ruft ab, ob für diesen File ein Ressourcenschlüssel für den Zugriff erforderlich ist, wenn er über einen Link freigegeben wird. Diese Anforderung ist für infrage kommende Dateien und Ordner standardmäßig aktiviert. Verwenden Sie setSecurityUpdateEnabled, um die Ressourcenschlüsselanforderung für zulässige Dateien zu aktivieren oder zu deaktivieren.

Weitere Informationen zum Sicherheitsupdate für Google Drive

Return

Boolean: Gibt an, ob die Ressourcenschlüsselanforderung für diese File aktiviert ist.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getSharingAccess()

Ruft ab, welche Klasse von Nutzern auf File zugreifen kann, ausgenommen einzelne Nutzer, denen explizit Zugriff gewährt wurde.

Return

Access: Welche Klasse von Nutzern auf File zugreifen kann

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getSharingPermission()

Ruft die Berechtigung für die Nutzer ab, die auf File zugreifen können, ausgenommen einzelne Nutzer, denen explizit Zugriff gewährt wurde.

Return

Permission: Berechtigungen für Nutzer, die auf File zugreifen können

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getSize()

Ruft die Anzahl der Byte ab, die zum Speichern von File in Drive verwendet werden. Hinweis: Google Workspace-Anwendungsdateien werden nicht auf das Google Drive-Speicherkontingent angerechnet und geben daher 0 Byte zurück.

Return

Integer: Anzahl der Byte zum Speichern von File in Drive

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getTargetId()

Bei einer Verknüpfung 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()}`);

Return

String: Die Zielartikel-ID.


getTargetMimeType()

Wenn es sich um einen Shortcut handelt, wird der MIME-Typ des Elements zurückgegeben, auf das es 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()}`);

Return

String: Der MIME-Typ des Zielelements.


getTargetResourceKey()

Wenn es sich bei der Datei um eine 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 keine 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());

Return

String: Der Ressourcenschlüssel des Zielelements oder null, wenn die Datei keine Verknüpfung ist.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getThumbnail()

Ruft eine Miniaturansicht für die Datei ab oder null, wenn keine Miniaturansicht 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());
}

Return

Blob: Die Miniaturansicht der Datei.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getUrl()

Ruft die URL ab, mit der File in einer Google-App wie Drive oder Docs geöffnet werden kann.

Return

String: die URL, mit der dieses File in einer Google-App wie Drive oder Docs aufgerufen werden kann

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getViewers()

Liste der Betrachter und Kommentatoren für diesen File abrufen Wenn der Nutzer, der das Skript 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 (viewer of viewers) {
    console.log(viewer.getEmail());
  }
}

Return

User[]: Wenn der Nutzer Bearbeitungszugriff auf 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

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

isShareableByEditors()

Bestimmt, ob Nutzer mit Bearbeitungsberechtigungen für File Dateien für andere Nutzer freigeben oder die Berechtigungen ändern dürfen.

Return

Boolean: true, wenn Nutzer mit Bearbeitungsberechtigungen Dateien für andere Nutzer freigeben oder die Berechtigungen ändern dürfen; false wenn nicht

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

isStarred()

Ermittelt, ob File in der Ablage des Nutzers markiert wurde.

Return

Boolean: true, wenn File in der Ablage des Nutzers markiert ist; false, wenn nicht

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

isTrashed()

Legt fest, ob sich das File-Element im Papierkorb des Nutzers in der Ablage des Nutzers befindet.

Return

Boolean: true, wenn sich die File im Papierkorb des Nutzers in Drive befindet; wenn nicht false

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

makeCopy()

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());
}

Return

File: Die neue Kopie.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

makeCopy(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

NameTypBeschreibung
destinationFolderDas Verzeichnis, in das die Datei kopiert werden soll.

Return

File: Die neue Kopie.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

makeCopy(name)

Erstellt eine Kopie der Datei und gibt ihr einen 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

NameTypBeschreibung
nameStringDer Dateiname, der auf die neue Kopie angewendet werden soll.

Return

File: Die neue Kopie.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

makeCopy(name, destination)

Erstellt im Zielverzeichnis eine Kopie der Datei und gibt ihr einen 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

NameTypBeschreibung
nameStringDer Dateiname, der auf die neue Kopie angewendet werden soll.
destinationFolderDas Verzeichnis, in das die Datei kopiert werden soll.

Return

File: Die neue Kopie.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

moveTo(destination)

Verschiebt dieses Element in den angegebenen Zielordner.

Der aktuelle Nutzer muss Eigentümer der Datei sein oder mindestens Bearbeitungszugriff auf den aktuellen übergeordneten Ordner des Elements haben, damit das Element in den Zielordner verschoben werden kann.

Parameter

NameTypBeschreibung
destinationFolderDer Ordner, der zum neuen übergeordneten Element wird

Return

File: Dieses File für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

removeCommenter(emailAddress)

Entfernt den angegebenen Nutzer aus der Liste der Kommentatoren für File. Diese Methode verhindert nicht, dass Nutzer auf File zugreifen, wenn sie zu einer Klasse von Nutzern gehören, die allgemeinen Zugriff haben, 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('cloudysanfrancisco@gmail.com');
}

Parameter

NameTypBeschreibung
emailAddressStringDie E-Mail-Adresse des Nutzers, der entfernt werden soll.

Return

File: Dieses File für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

removeCommenter(user)

Entfernt den angegebenen Nutzer aus der Liste der Kommentatoren für File. Diese Methode verhindert nicht, dass Nutzer auf File zugreifen, wenn sie zu einer Klasse von Nutzern gehören, die allgemeinen Zugriff haben, 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

NameTypBeschreibung
userUserEine Darstellung des Nutzers, der entfernt werden soll.

Return

File: Dieses File für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

removeEditor(emailAddress)

Entfernt den angegebenen Nutzer aus der Liste der Bearbeiter für File. Diese Methode verhindert nicht, dass Nutzer auf File zugreifen, wenn sie zu einer Klasse von Nutzern mit allgemeinen Zugriff gehören. Das ist z. B. der Fall, wenn File für die gesamte Domain des Nutzers freigegeben ist oder wenn sich File in einer geteilten Ablage befindet, auf die der Nutzer zugreifen kann.

Bei Drive-Dateien wird der Nutzer auch aus der Liste der Viewer entfernt.

Parameter

NameTypBeschreibung
emailAddressStringDie E-Mail-Adresse des Nutzers, der entfernt werden soll.

Return

File: Dieses File für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

removeEditor(user)

Entfernt den angegebenen Nutzer aus der Liste der Bearbeiter für File. Diese Methode verhindert nicht, dass Nutzer auf File zugreifen, wenn sie zu einer Klasse von Nutzern mit allgemeinen Zugriff gehören. Das ist z. B. der Fall, wenn File für die gesamte Domain des Nutzers freigegeben ist oder wenn sich File in einer geteilten Ablage befindet, auf die der Nutzer zugreifen kann.

Bei Drive-Dateien wird der Nutzer auch aus der Liste der Viewer entfernt.

Parameter

NameTypBeschreibung
userUserEine Darstellung des Nutzers, der entfernt werden soll.

Return

File: Dieses File für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

removeViewer(emailAddress)

Entfernt den angegebenen Nutzer aus der Liste der Betrachter und Kommentatoren für File. Diese Methode hat keine Auswirkungen, wenn der Nutzer Bearbeiter und kein Betrachter oder Kommentator ist. Außerdem wird durch diese Methode nicht verhindert, dass Nutzer auf File zugreifen, wenn sie zu einer Klasse von Nutzern mit allgemeinem Zugriff gehören, z. B. wenn die File für die gesamte Domain des Nutzers freigegeben ist oder wenn sich File in einer geteilten Ablage befindet, auf die der Nutzer zugreifen kann.

Bei Drive-Dateien wird der Nutzer auch aus der Liste der Bearbeiter entfernt.

Parameter

NameTypBeschreibung
emailAddressStringDie E-Mail-Adresse des Nutzers, der entfernt werden soll.

Return

File: File für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

removeViewer(user)

Entfernt den angegebenen Nutzer aus der Liste der Betrachter und Kommentatoren für File. Diese Methode hat keine Auswirkungen, wenn der Nutzer Bearbeiter und kein Betrachter ist. Außerdem verhindert diese Methode nicht, dass Nutzer auf File zugreifen, wenn sie zu einer Klasse von Nutzern mit allgemeinem Zugriff gehören, z. B. wenn File für die gesamte Domain des Nutzers freigegeben ist oder wenn sich File in einer geteilten Ablage befindet, auf die der Nutzer zugreifen kann.

Bei Drive-Dateien wird der Nutzer auch aus der Liste der Bearbeiter entfernt.

Parameter

NameTypBeschreibung
userUserEine Darstellung des Nutzers, der entfernt werden soll.

Return

File: File für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

revokePermissions(emailAddress)

Hebt den Zugriff auf die File auf, die dem jeweiligen Nutzer gewährt wurden. Diese Methode verhindert nicht, dass Nutzer auf File zugreifen, wenn sie zu einer Klasse von Nutzern mit allgemeinen Zugriff gehören. Dies ist beispielsweise dann der Fall, wenn die File für die gesamte Domain des Nutzers freigegeben ist.

Parameter

NameTypBeschreibung
emailAddressStringDie E-Mail-Adresse des Nutzers, dessen Zugriff widerrufen werden soll.

Return

File: Dieses File für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

revokePermissions(user)

Hebt den Zugriff auf die File auf, die dem jeweiligen Nutzer gewährt wurden. Diese Methode verhindert nicht, dass Nutzer auf File zugreifen, wenn sie zu einer Klasse von Nutzern mit allgemeinen Zugriff gehören. Dies ist beispielsweise dann der Fall, wenn die File für die gesamte Domain des Nutzers freigegeben ist.

Parameter

NameTypBeschreibung
userUserDarstellung des Nutzers, dessen Zugriff widerrufen werden soll

Return

File: Dieses File für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

setContent(content)

Überschreibt den Inhalt der Datei mit einem bestimmten Ersatz. Löst eine Ausnahme aus, wenn content größer als 10 MB ist.

// Creates a text file with the content 'Hello, world!'
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

NameTypBeschreibung
contentStringDer neue Inhalt der Datei.

Return

File: Dieses File für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

setDescription(description)

Legt die Beschreibung für File fest.

Parameter

NameTypBeschreibung
descriptionStringDie neue Beschreibung für File

Return

File – dieses File für Verkettung

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

setName(name)

Legt den Namen von File fest.

Parameter

NameTypBeschreibung
nameStringden neuen Namen von File

Return

File – dieses File für Verkettung

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

setOwner(emailAddress)

Eigentümer von File ändern Mit dieser Methode erhält der vorherige Inhaber außerdem expliziten Bearbeitungszugriff auf die File.

Parameter

NameTypBeschreibung
emailAddressStringdie E-Mail-Adresse des Nutzers, der der neue Inhaber werden soll

Return

File – dieses File für Verkettung

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

setOwner(user)

Eigentümer von File ändern Mit dieser Methode erhält der vorherige Inhaber außerdem expliziten Bearbeitungszugriff auf die File.

Parameter

NameTypBeschreibung
userUsereine Darstellung des Nutzers, der neuer Inhaber werden soll

Return

File – dieses File für Verkettung

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

setSecurityUpdateEnabled(enabled)

Legt fest, ob das File für den Zugriff einen Ressourcenschlüssel erfordert, wenn es über einen Link freigegeben wird. Zulässige Dateien und Ordner sind standardmäßig aktiviert.

Weitere Informationen zum Sicherheitsupdate für Google Drive

Parameter

NameTypBeschreibung
enabledBooleanGibt an, ob die Ressourcenschlüsselanforderung für File aktiviert werden soll.

Return

File: Dieses File für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

setShareableByEditors(shareable)

Legt fest, ob Nutzer mit Bearbeitungsberechtigungen für File Dateien für andere Nutzer freigeben oder die Berechtigungen ändern dürfen. Der Standardwert für eine neue File ist true.

Parameter

NameTypBeschreibung
shareableBooleantrue, wenn Nutzer mit Bearbeitungsberechtigungen berechtigt sein sollen, Dateien für andere Nutzer freizugeben oder die Berechtigungen zu ändern; false wenn nicht

Return

File – dieses File für Verkettung

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

setSharing(accessType, permissionType)

Legt fest, welche Klasse von Nutzern auf File zugreifen kann und welche Berechtigungen diesen Nutzern gewährt werden, abgesehen von einzelnen Nutzern, denen explizit Zugriff gewährt wurde.

// 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.)
var folder = DriveApp.createFolder('Shared Folder');
folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);

Parameter

NameTypBeschreibung
accessTypeAccesswelche Klasse von Nutzern Zugriff auf File haben soll
permissionTypePermissiondie Berechtigungen, die Nutzern gewährt werden sollten, die auf File zugreifen können

Return

File – dieses File für Verkettung

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

setStarred(starred)

Legt fest, ob das File in der Ablage des Nutzers markiert ist. Der Standardwert für neue Files ist false.

Parameter

NameTypBeschreibung
starredBooleantrue, wenn File in der Ablage des Nutzers markiert werden soll; false wenn nicht

Return

File – dieses File für Verkettung

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive

setTrashed(trashed)

Legt fest, ob sich das File-Element im Papierkorb des Nutzers in der Ablage des Nutzers befindet. Nur der Inhaber kann File in den Papierkorb verschieben. Der Standardwert für neue Files ist false.

Parameter

NameTypBeschreibung
trashedBooleantrue, wenn File in den Papierkorb des Nutzers verschoben werden soll; false andernfalls

Return

File – dieses File für Verkettung

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/drive