Class File

Datei

Eine Datei in Google Drive Über DriveApp können Sie auf Dateien zugreifen oder sie 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

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 Nutzer-Array 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 Nutzer-Array der Liste der Bearbeiter für File hinzu.
addViewer(emailAddress)FileFügt den angegebenen Nutzer der Liste der Zuschauer für File hinzu.
addViewer(user)FileFügt den angegebenen Nutzer der Liste der Zuschauer für File hinzu.
addViewers(emailAddresses)FileFügt das angegebene Nutzer-Array der Liste der Betrachter für File hinzu.
getAccess(email)PermissionRuft die Berechtigung ab, die einem bestimmten Nutzer gewährt wurde.
getAccess(user)PermissionRuft die Berechtigung ab, die einem bestimmten 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()DateGibt das Datum zurück, an dem File erstellt wurde.
getDescription()StringRuft die Beschreibung für die File ab.
getDownloadUrl()StringRuft die URL ab, die zum Herunterladen der Datei verwendet werden kann.
getEditors()User[]Ruft die Liste der Mitbearbeiter für diese File ab.
getId()StringRuft die ID des File ab.
getLastUpdated()DateGibt das Datum zurück, 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 unmittelbar übergeordnete Elemente von File sind.
getResourceKey()StringRuft den Ressourcenschlüssel des File ab, der für den Zugriff auf Elemente erforderlich ist, die über einen Link freigegeben wurden.
getSecurityUpdateEligible()BooleanGibt an, ob für dieses File das Sicherheitsupdate angewendet werden kann, für das ein Ressourcenschlüssel für den Zugriff erforderlich ist, wenn es über einen Link freigegeben wird.
getSecurityUpdateEnabled()BooleanGibt an, ob für den Zugriff auf diese File ein Ressourcenschlüssel erforderlich ist, wenn sie über einen Link freigegeben wird.
getSharingAccess()AccessRuft ab, welche Nutzerklasse auf die File zugreifen kann, abgesehen von einzelnen Nutzern, denen explizit Zugriff gewährt wurde.
getSharingPermission()PermissionRuft die Berechtigung ab, die Nutzern mit Zugriff auf File gewährt wird, mit Ausnahme von einzelnen Nutzern, denen explizit Zugriff gewährt wurde.
getSize()IntegerGibt die Anzahl der Byte zurück, die zum Speichern des File in Drive verwendet werden.
getTargetId()StringWenn es sich um eine Verknüpfung handelt, wird die ID des Elements zurückgegeben, auf das sie verweist.
getTargetMimeType()StringWenn es sich um eine Verknüpfung handelt, wird der MIME-Typ des Elements zurückgegeben, auf das sie verweist.
getTargetResourceKey()StringWenn die Datei eine Verknüpfung ist, wird der Ressourcenschlüssel des Elements zurückgegeben, auf das sie verweist.
getThumbnail()Blob|nullRuft eine Miniaturansicht für die Datei ab oder null, wenn keine Miniaturansicht vorhanden ist.
getUrl()StringRuft die URL ab, mit der die File in einer Google-App wie Drive oder Docs geöffnet werden kann.
getViewers()User[]Ruft die Liste der Betrachter und Kommentatoren für diese File ab.
isShareableByEditors()BooleanBestimmt, ob Nutzer mit Bearbeitungsberechtigungen für die File die Datei für andere Nutzer freigeben oder die Berechtigungen ändern dürfen.
isStarred()BooleanGibt an, ob die File in Google Drive des Nutzers mit einem Sternchen markiert wurde.
isTrashed()BooleanGibt an, ob sich die File im Papierkorb des Drive-Kontos 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 benennt sie mit dem angegebenen Namen.
makeCopy(name, destination)FileErstellt eine Kopie der Datei im Zielverzeichnis und benennt sie mit dem angegebenen Namen.
moveTo(destination)FileVerschiebt dieses Element in den angegebenen Zielordner.
removeCommenter(emailAddress)FileEntfernt den angegebenen Nutzer aus der Liste der Kommentatoren für die File.
removeCommenter(user)FileEntfernt den angegebenen Nutzer aus der Liste der Kommentatoren für die File.
removeEditor(emailAddress)FileEntfernt den angegebenen Nutzer aus der Liste der Mitbearbeiter für die File.
removeEditor(user)FileEntfernt den angegebenen Nutzer aus der Liste der Mitbearbeiter für die File.
removeViewer(emailAddress)FileEntfernt den angegebenen Nutzer aus der Liste der Zuschauer und Kommentatoren für die File.
removeViewer(user)FileEntfernt den angegebenen Nutzer aus der Liste der Zuschauer und Kommentatoren für die File.
revokePermissions(emailAddress)FileWiderruft den Zugriff auf File, der dem angegebenen Nutzer gewährt wurde.
revokePermissions(user)FileWiderruft den Zugriff auf File, der dem angegebenen Nutzer gewährt wurde.
setContent(content)FileÜberschreibt den Inhalt der Datei mit einem angegebenen Ersatz.
setDescription(description)FileLegt die Beschreibung für File fest.
setName(name)FileLegt den Namen des File fest.
setOwner(emailAddress)FileÄndert den Inhaber von File.
setOwner(user)FileÄndert den Inhaber von File.
setSecurityUpdateEnabled(enabled)FileLegt fest, ob für den Zugriff auf File ein Ressourcenschlüssel erforderlich ist, wenn die Datei über einen Link freigegeben wird.
setShareableByEditors(shareable)FileGibt an, ob Nutzer mit Bearbeitungsberechtigungen für die File die Datei für andere Nutzer freigeben oder die Berechtigungen ändern dürfen.
setSharing(accessType, permissionType)FileLegt fest, welche Nutzerklasse auf File zugreifen kann und welche Berechtigungen diesen Nutzern erteilt werden, abgesehen von einzelnen Nutzern, denen explizit Zugriff gewährt wurde.
setStarred(starred)FileLegt fest, ob die File in Google Drive des Nutzers mit einem Sternchen markiert ist.
setTrashed(trashed)FileLegt fest, ob sich die File im Papierkorb des Drive-Kontos des Nutzers befindet.

Detaillierte Dokumentation

addCommenter(emailAddress)

Fügen Sie den angegebenen Nutzer der Liste der Kommentatoren für File hinzu. Wenn der Nutzer bereits in der Liste der Zuschauer war, wird er durch diese Methode aus der Liste der Zuschauer entfernt.

const files = DriveApp.getFilesByName('Test');

// Loops through the files
while (files.hasNext()) {
  const file = files.next();
  file.addCommenter('hello@example.com');
}

Parameter

NameTypBeschreibung
emailAddressStringDie E-Mail-Adresse des Nutzers, den Sie hinzufügen möchten.

Rückflug

File – Diese File zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

addCommenter(user)

Fügen Sie den angegebenen Nutzer der Liste der Kommentatoren für File hinzu. Wenn der Nutzer bereits in der Liste der Zuschauer war, wird er durch diese Methode aus der Liste der Zuschauer 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

NameTypBeschreibung
userUserEine Darstellung des hinzuzufügenden Nutzers.

Rückflug

File – Diese File zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

addCommenters(emailAddresses)

Fügen Sie das angegebene Nutzer-Array der Liste der Kommentatoren für File hinzu. Wenn sich Nutzer bereits auf der Liste der Zuschauer befanden, werden sie durch diese Methode aus der Liste der Zuschauer 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 '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 den E‑Mail-Adressen der Nutzer, die hinzugefügt werden sollen.

Rückflug

File – Diese File zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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 Zuschauer war, wird er durch diese Methode aus der Liste entfernt.

Parameter

NameTypBeschreibung
emailAddressStringDie E-Mail-Adresse des Nutzers, den Sie hinzufügen möchten.

Rückflug

File – Diese File zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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 Zuschauer war, wird er durch diese Methode aus der Liste entfernt.

Parameter

NameTypBeschreibung
userUserEine Darstellung des hinzuzufügenden Nutzers.

Rückflug

File – Diese File zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

addEditors(emailAddresses)

Fügt das angegebene Nutzer-Array der Liste der Bearbeiter für File hinzu. Wenn einer der Nutzer bereits in der Liste der Zuschauer war, wird er durch diese Methode aus der Liste der Zuschauer entfernt.

Parameter

NameTypBeschreibung
emailAddressesString[]Ein Array mit den E‑Mail-Adressen der Nutzer, die hinzugefügt werden sollen.

Rückflug

File – Diese File zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

addViewer(emailAddress)

Fügt den angegebenen Nutzer der Liste der Zuschauer für File hinzu. Wenn der Nutzer bereits in der Liste der Bearbeiter enthalten war, hat diese Methode keine Auswirkungen.

Parameter

NameTypBeschreibung
emailAddressStringDie E-Mail-Adresse des Nutzers, den Sie hinzufügen möchten.

Rückflug

File – Diese File zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

addViewer(user)

Fügt den angegebenen Nutzer der Liste der Zuschauer für File hinzu. Wenn der Nutzer bereits in der Liste der Bearbeiter enthalten war, hat diese Methode keine Auswirkungen.

Parameter

NameTypBeschreibung
userUserEine Darstellung des hinzuzufügenden Nutzers.

Rückflug

File – Diese File zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

addViewers(emailAddresses)

Fügt das angegebene Nutzer-Array der Liste der Betrachter für File hinzu. Wenn einer der Nutzer bereits in der Liste der Bearbeiter enthalten war, hat diese Methode keine Auswirkungen auf ihn.

Parameter

NameTypBeschreibung
emailAddressesString[]Ein Array mit den E‑Mail-Adressen der Nutzer, die hinzugefügt werden sollen.

Rückflug

File – Diese File zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

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

NameTypBeschreibung
emailStringDie E‑Mail-Adresse des Nutzers, dessen Berechtigungen geprüft werden sollen. Google Groups werden nicht unterstützt.

Rückflug

Permission: Die dem Nutzer gewährten Berechtigungen.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

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

NameTypBeschreibung
userUserEine Darstellung des Nutzers, dessen Berechtigungen geprüft werden sollen.

Rückflug

Permission: Die dem Nutzer gewährten Berechtigungen.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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. Mit dieser Methode wird dem Dateinamen die entsprechende Erweiterung hinzugefügt, z. B. „meine_datei.pdf“. Dabei wird jedoch davon ausgegangen, dass der Teil des Dateinamens, der auf den letzten Punkt folgt (falls vorhanden), eine vorhandene Erweiterung ist, die ersetzt werden soll. Folglich wird aus „ShoppingList.12.25.2014“ „ShoppingList.12.25.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

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. Für ein Google Docs-Dokument ist auch 'text/markdown' gültig.

Rückflug

Blob: Die Daten als Blob.


getBlob()

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

Rückflug

Blob: Die Daten als Blob.


getDateCreated()

Gibt das Datum zurück, an dem File erstellt wurde.

Rückflug

Date: Das Datum, an dem die File erstellt wurde.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getDescription()

Ruft die Beschreibung für die File ab.

Rückflug

String – die Beschreibung für die File

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getDownloadUrl()

Ruft die URL ab, die zum Herunterladen der Datei verwendet werden kann. Nur Nutzer mit der Berechtigung zum Öffnen der Datei in Google Drive können auf die URL zugreifen. Sie können diese URL in einem Browser verwenden, um die Datei herunterzuladen, aber nicht, um die Datei mit UrlFetchApp abzurufen. Wenn Sie den Inhalt der Datei im Skript verwenden 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());
}

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getEditors()

Ruft die Liste der Mitbearbeiter 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();

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

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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getId()

Ruft die ID des File ab.

Rückflug

String: die ID des File

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getLastUpdated()

Gibt das Datum zurück, an dem File zuletzt aktualisiert wurde.

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

Rückflug

String: Der MIME-Typ der Datei.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getName()

Ruft den Namen des File ab.

Rückflug

String – der Name der File

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

Rückflug

User: Der Dateieigentümer.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getParents()

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

Rückflug

FolderIterator: Eine Sammlung von Ordnern, die die unmittelbaren übergeordneten Elemente des File sind.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getResourceKey()

Ruft den Ressourcenschlüssel des File ab, der für den 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getSecurityUpdateEligible()

Gibt an, ob für dieses File das Sicherheitsupdate angewendet werden kann, für das ein Ressourcenschlüssel für den Zugriff erforderlich ist, wenn es über einen Link freigegeben wird.

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 Aktualisierung ist für berechtigte Dateien und Ordner standardmäßig aktiviert. Mit setSecurityUpdateEnabled können Sie die Anforderung für Ressourcenschlüssel für infrage kommende 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 die File angewendet werden kann.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getSecurityUpdateEnabled()

Gibt an, ob für den Zugriff auf diese File ein Ressourcenschlüssel 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 infrage kommende 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getSharingAccess()

Ruft ab, welche Nutzerklasse auf die File zugreifen kann, abgesehen von einzelnen Nutzern, denen explizit Zugriff gewährt wurde.

Rückflug

Access – welche Nutzerklasse auf die File zugreifen kann

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getSharingPermission()

Ruft die Berechtigung ab, die Nutzern mit Zugriff auf File gewährt wird, mit Ausnahme von einzelnen Nutzern, denen explizit Zugriff gewährt wurde.

Rückflug

Permission: Die Berechtigungen, die Nutzern mit Zugriff auf die File gewährt werden.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getSize()

Gibt die Anzahl der Byte zurück, die zum Speichern des File in Drive verwendet werden. Dateien von Google Workspace-Anwendungen werden nicht auf die Speicherplatzlimits von Drive angerechnet und geben daher 0 Bytes zurück.

Rückflug

Integer – die Anzahl der Byte, die zum Speichern der File in Drive verwendet werden

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getTargetId()

Wenn es sich um eine 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.


getTargetMimeType()

Wenn es sich um eine 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 Ziel-Elements.


getTargetResourceKey()

Wenn die Datei eine Verknüpfung ist, 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());

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

Rückflug

Blob|null: Die Miniaturansicht der Datei.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getUrl()

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, die verwendet werden kann, um dieses File in einer Google-App wie Drive oder Docs aufzurufen.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getViewers()

Ruft die Liste der Betrachter und Kommentatoren für diese 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();

  // 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 dieses 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

isShareableByEditors()

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

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

isStarred()

Gibt an, ob das File in Google Drive des Nutzers mit einem Sternchen markiert wurde.

Rückflug

Boolean – true, wenn das File in der Ablage des Nutzers mit einem Sternchen markiert ist; false, wenn nicht

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

isTrashed()

Gibt an, ob sich die File im Papierkorb des Drive-Kontos des Nutzers befindet.

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

Rückflug

File: Der neue Text.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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.

Rückflug

File: Der neue Text.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

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

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

Rückflug

File: Der neue Text.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

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

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

Rückflug

File: Der neue Text.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

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

NameTypBeschreibung
destinationFolderDer Ordner, der das neue übergeordnete Element wird.

Rückflug

File – Diese File zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

removeCommenter(emailAddress)

Entfernt den angegebenen Nutzer aus der Liste der Kommentatoren für die File. Mit dieser Methode wird der Zugriff von Nutzern auf die File nicht blockiert, wenn sie zu einer Nutzerklasse gehören, die allgemeinen Zugriff hat, 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.

Rückflug

File – Diese File zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

removeCommenter(user)

Entfernt den angegebenen Nutzer aus der Liste der Kommentatoren für die File. Mit dieser Methode wird der Zugriff von Nutzern auf die File nicht blockiert, wenn sie zu einer Nutzerklasse gehören, die allgemeinen Zugriff hat, 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 zu entfernenden Nutzers.

Rückflug

File – Diese File zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

removeEditor(emailAddress)

Entfernt den angegebenen Nutzer aus der Liste der Mitbearbeiter für die File. Mit dieser Methode wird der Zugriff von Nutzern auf die File nicht blockiert, wenn sie zu einer Nutzerklasse gehören, die allgemeinen Zugriff hat. 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 dadurch auch aus der Liste der Betrachter entfernt.

Parameter

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

Rückflug

File – Diese File zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

removeEditor(user)

Entfernt den angegebenen Nutzer aus der Liste der Mitbearbeiter für die File. Mit dieser Methode wird der Zugriff von Nutzern auf die File nicht blockiert, wenn sie zu einer Nutzerklasse gehören, die allgemeinen Zugriff hat. 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 dadurch auch aus der Liste der Betrachter entfernt.

Parameter

NameTypBeschreibung
userUserEine Darstellung des zu entfernenden Nutzers.

Rückflug

File – Diese File zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

removeViewer(emailAddress)

Entfernt den angegebenen Nutzer aus der Liste der Zuschauer und Kommentatoren für die File. Diese Methode hat keine Auswirkungen, wenn der Nutzer ein Bearbeiter und kein Betrachter oder Kommentator ist. Mit dieser Methode wird auch nicht verhindert, dass Nutzer auf die File zugreifen, wenn sie zu einer Nutzergruppe gehören, die allgemeinen Zugriff hat. Das ist beispielsweise der Fall, wenn die File für die gesamte Domain des Nutzers freigegeben ist oder wenn 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 Mitbearbeiter entfernt.

Parameter

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

Rückflug

File – Diese File für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

removeViewer(user)

Entfernt den angegebenen Nutzer aus der Liste der Zuschauer und Kommentatoren für die File. Diese Methode hat keine Auswirkungen, wenn der Nutzer ein Bearbeiter und kein Betrachter ist. Mit dieser Methode wird auch nicht verhindert, dass Nutzer auf die File zugreifen, wenn sie zu einer Nutzerklasse gehören, die allgemeinen Zugriff hat. Das ist beispielsweise der Fall, wenn die File für die gesamte Domain des Nutzers freigegeben ist oder wenn 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 Mitbearbeiter entfernt.

Parameter

NameTypBeschreibung
userUserEine Darstellung des zu entfernenden Nutzers.

Rückflug

File – Diese File für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

revokePermissions(emailAddress)

Widerruft den Zugriff auf File, der dem angegebenen Nutzer gewährt wurde. Mit dieser Methode wird der Zugriff von Nutzern auf die File nicht blockiert, wenn sie zu einer Nutzerklasse gehören, die allgemeinen Zugriff hat, z. B. 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.

Rückflug

File – Diese File zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

revokePermissions(user)

Widerruft den Zugriff auf File, der dem angegebenen Nutzer gewährt wurde. Mit dieser Methode wird der Zugriff von Nutzern auf die File nicht blockiert, wenn sie zu einer Nutzerklasse gehören, die allgemeinen Zugriff hat, z. B. wenn die File für die gesamte Domain des Nutzers freigegeben ist.

Parameter

NameTypBeschreibung
userUserEine Darstellung des Nutzers, dessen Zugriff widerrufen werden soll.

Rückflug

File – Diese File zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setContent(content)

Überschreibt den Inhalt der Datei mit einem angegebenen Ersatz. Löst eine Ausnahme aus, 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

NameTypBeschreibung
contentStringDie neuen Inhalte für die Datei.

Rückflug

File – Diese File zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setDescription(description)

Legt die Beschreibung für File fest.

Parameter

NameTypBeschreibung
descriptionStringdie neue Beschreibung für File

Rückflug

File – diese File zur Verkettung

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setName(name)

Legt den Namen des File fest.

Parameter

NameTypBeschreibung
nameStringDer neue Name der File

Rückflug

File – diese File zur Verkettung

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setOwner(emailAddress)

Ändert den Inhaber von File. Mit dieser Methode erhält der bisherige Inhaber auch expliziten Bearbeitungszugriff auf die File.

Parameter

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

Rückflug

File – diese File zur Verkettung

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setOwner(user)

Ändert den Inhaber von File. Mit dieser Methode erhält der bisherige Inhaber auch expliziten Bearbeitungszugriff auf die File.

Parameter

NameTypBeschreibung
userUserEine Darstellung des Nutzers, der der neue Inhaber werden soll

Rückflug

File – diese File zur Verkettung

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setSecurityUpdateEnabled(enabled)

Legt fest, ob für den Zugriff auf File ein Ressourcenschlüssel erforderlich ist, wenn die Datei über einen Link freigegeben wird. Geeignete Dateien und Ordner sind standardmäßig aktiviert.

Weitere Informationen zum Sicherheitsupdate für Google Drive

Parameter

NameTypBeschreibung
enabledBooleanGibt an, ob die Anforderung des Ressourcenschlüssels für die File aktiviert werden soll.

Rückflug

File – Diese File zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setShareableByEditors(shareable)

Gibt an, ob Nutzer mit Bearbeitungsberechtigungen für die File die Datei für andere Nutzer freigeben oder die Berechtigungen ändern dürfen. Der Standardwert für ein neues File ist true.

Parameter

NameTypBeschreibung
shareableBooleantrue, wenn Nutzer mit Bearbeitungsberechtigungen die Berechtigungen ändern oder Elemente für andere Nutzer freigeben dürfen, false, wenn nicht

Rückflug

File – diese File zur Verkettung

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setSharing(accessType, permissionType)

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

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

NameTypBeschreibung
accessTypeAccessWelche Nutzerklasse sollte auf die File zugreifen können?
permissionTypePermissiondie Berechtigungen, die Nutzern mit Zugriff auf die File gewährt werden sollen

Rückflug

File – diese File zur Verkettung

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setStarred(starred)

Legt fest, ob die File in Google Drive des Nutzers mit einem Sternchen markiert ist. Der Standardwert für neue Files ist false.

Parameter

NameTypBeschreibung
starredBooleantrue, wenn die File in der Drive-Ablage des Nutzers mit einem Sternchen markiert werden soll; false, wenn nicht

Rückflug

File – diese File zur Verkettung

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setTrashed(trashed)

Legt fest, ob sich die File im Papierkorb des Drive-Kontos des Nutzers befindet. Nur der Eigentümer kann File in den Papierkorb verschieben. Der Standardwert für neue Files ist false.

Parameter

NameTypBeschreibung
trashedBooleantrue, wenn die File in den Papierkorb der Ablage des Nutzers verschoben werden soll; false, wenn nicht

Rückflug

File – diese File zur Verkettung

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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