Class File

Datei

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

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

Methoden

MethodeRückgabetypKurzbeschreibung
addCommenter(emailAddress)FileFügen Sie den angegebenen Nutzer der Liste der Kommentatoren für die File hinzu.
addCommenter(user)FileFügen Sie den angegebenen Nutzer der Liste der Kommentatoren für die File hinzu.
addCommenters(emailAddresses)FileFüge der Liste der Kommentatoren für die File das angegebene Array von Nutzern hinzu.
addEditor(emailAddress)FileDer angegebene Nutzer wird der Liste der Mitbearbeiter für die File hinzugefügt.
addEditor(user)FileDer angegebene Nutzer wird der Liste der Mitbearbeiter für die File hinzugefügt.
addEditors(emailAddresses)FileFügt der Liste der Mitbearbeiter für die File das angegebene Nutzerarray hinzu.
addViewer(emailAddress)FileDer angegebene Nutzer wird der Liste der Zuschauer für die File hinzugefügt.
addViewer(user)FileDer angegebene Nutzer wird der Liste der Zuschauer für die File hinzugefügt.
addViewers(emailAddresses)FileFügen Sie der Liste der Zuschauer für die File das angegebene Array von Nutzern 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, der in den angegebenen Inhaltstyp konvertiert wurde.
getBlob()BlobGibt die Daten in diesem Objekt als Blob zurück.
getDateCreated()DateDas Datum, an dem die File erstellt wurde.
getDescription()StringRuft die Beschreibung für die File ab.
getDownloadUrl()StringRuft die URL ab, über die die Datei heruntergeladen werden kann.
getEditors()User[]Ruft die Liste der Mitbearbeiter für diese File ab.
getId()StringRuft die ID der File ab.
getLastUpdated()DateDas Datum, an dem die File zuletzt aktualisiert wurde.
getMimeType()StringRuft den MIME-Typ der Datei ab.
getName()StringRuft den Namen der File ab.
getOwner()UserRuft den Eigentümer der Datei ab.
getParents()FolderIteratorEine Sammlung von Ordnern wird abgerufen, die unmittelbar übergeordnete Elemente von File sind.
getResourceKey()StringRuft den Ressourcenschlüssel der File ab, der zum Zugriff auf Elemente erforderlich ist, die über einen Link freigegeben wurden.
getSecurityUpdateEligible()BooleanGibt an, ob für diese File das Sicherheitsupdate angewendet werden kann, für das ein Ressourcenschlüssel für den Zugriff erforderlich ist, wenn die Datei über einen Link freigegeben wird.
getSecurityUpdateEnabled()BooleanGibt an, ob für diese File ein Ressourcenschlüssel für den Zugriff erforderlich ist, wenn sie über einen Link freigegeben wird.
getSharingAccess()AccessGibt an, welche Nutzergruppe neben einzelnen Nutzern, denen explizit Zugriff gewährt wurde, auf das File zugreifen kann.
getSharingPermission()PermissionRuft die Berechtigung ab, die Nutzern gewährt wurde, die auf die File zugreifen können, sowie die Berechtigung einzelner Nutzer, denen explizit Zugriff gewährt wurde.
getSize()IntegerDie Anzahl der Byte, die zum Speichern der File in Drive verwendet werden.
getTargetId()StringWenn es sich um einen Verknüpfung handelt, wird die ID des Elements zurückgegeben, auf das sie verweist.
getTargetMimeType()StringWenn es sich um einen Verknüpfung handelt, wird der MIME-Typ des Elements zurückgegeben, auf das sie verweist.
getTargetResourceKey()StringWenn es sich bei der Datei um einen Verknüpfung handelt, wird der Ressourcenschlüssel des Elements zurückgegeben, auf das sie verweist.
getThumbnail()BlobHier wird ein Thumbnail-Bild für die Datei abgerufen oder null, wenn kein Thumbnail 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 Inhalte für andere Nutzer freigeben oder die Berechtigungen ändern dürfen.
isStarred()BooleanGibt an, ob die File im Drive des Nutzers mit einem Stern markiert wurde.
isTrashed()BooleanBestimmt, ob sich die File im Papierkorb des Nutzers in Google Drive 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)FileDer angegebene Nutzer wird aus der Liste der Kommentatoren für die File entfernt.
removeCommenter(user)FileDer angegebene Nutzer wird aus der Liste der Kommentatoren für die File entfernt.
removeEditor(emailAddress)FileDer angegebene Nutzer wird aus der Liste der Mitbearbeiter der File entfernt.
removeEditor(user)FileDer angegebene Nutzer wird aus der Liste der Mitbearbeiter der File entfernt.
removeViewer(emailAddress)FileDer angegebene Nutzer wird aus der Liste der Zuschauer und Kommentatoren für die File entfernt.
removeViewer(user)FileDer angegebene Nutzer wird aus der Liste der Zuschauer und Kommentatoren für die File entfernt.
revokePermissions(emailAddress)FileHiermit wird der dem Nutzer gewährte Zugriff auf File widerrufen.
revokePermissions(user)FileHiermit wird der dem Nutzer gewährte Zugriff auf File widerrufen.
setContent(content)FileÜberschreibt den Inhalt der Datei mit einem bestimmten Ersatz.
setDescription(description)FileLegt die Beschreibung für die File fest.
setName(name)FileLegt den Namen der File fest.
setOwner(emailAddress)FileÄndert den Inhaber der File.
setOwner(user)FileÄndert den Inhaber der File.
setSecurityUpdateEnabled(enabled)FileLegt fest, ob für den Zugriff auf die File ein Ressourcenschlüssel erforderlich ist, wenn sie über einen Link freigegeben wird.
setShareableByEditors(shareable)FileHier legen Sie fest, ob Nutzer mit Bearbeitungsberechtigungen für die File die Inhalte für andere Nutzer freigeben oder die Berechtigungen ändern dürfen.
setSharing(accessType, permissionType)FileHier wird festgelegt, welche Nutzergruppe auf die File zugreifen kann und welche Berechtigungen diesen Nutzern gewährt werden, zusätzlich zu einzelnen Nutzern, die ausdrücklich Zugriff erhalten haben.
setStarred(starred)FileGibt an, ob die File im Drive des Nutzers mit einem Stern markiert ist.
setTrashed(trashed)FileGibt an, 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 die File hinzu. Wenn der Nutzer bereits in der Liste der Zuschauer war, wird er durch diese Methode aus der Liste entfernt.

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

// Loops through the files
while (files.hasNext()) {
  const file = files.next();
  file.addCommenter('[email protected]');
}

Parameter

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

Rückflug

File – Dieses File für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

addCommenter(user)

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

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Adds the active user as a commenter.
while (files.hasNext()) {
  const file = files.next();
  file.addCommenter(Session.getActiveUser());
}

Parameter

NameTypBeschreibung
userUserEine Darstellung des hinzuzufügenden Nutzers.

Rückflug

File – Dieses File für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

addCommenters(emailAddresses)

Füge der Liste der Kommentatoren für die File das angegebene Array von Nutzern hinzu. Wenn einer der Nutzer bereits in der Liste der Zuschauer stand, wird er durch diese Methode aus der Liste entfernt.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

while (files.hasNext()) {
  const file = files.next();
  // TODO(developer): Replace '[email protected]' and
  // '[email protected]' with the email addresses to add as
  // commenters.
  const emails = [
    '[email protected]',
    '[email protected]',
  ];
  console.log(file.addCommenters(emails));
}

Parameter

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

Rückflug

File – Dieses File für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

addEditor(emailAddress)

Der angegebene Nutzer wird der Liste der Mitbearbeiter für die File hinzugefügt. Wenn der Nutzer bereits auf der Liste der Zuschauer stand, wird er durch diese Methode aus der Liste entfernt.

Parameter

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

Rückflug

File – Dieses File für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

addEditor(user)

Der angegebene Nutzer wird der Liste der Mitbearbeiter für die File hinzugefügt. Wenn der Nutzer bereits auf der Liste der Zuschauer stand, wird er durch diese Methode aus der Liste entfernt.

Parameter

NameTypBeschreibung
userUserEine Darstellung des hinzuzufügenden Nutzers.

Rückflug

File – Dieses File für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

addEditors(emailAddresses)

Fügt der Liste der Mitbearbeiter für die File das angegebene Nutzerarray hinzu. Wenn sich einer der Nutzer bereits in der Liste der Zuschauer befand, wird er durch diese Methode aus der Liste entfernt.

Parameter

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

Rückflug

File – Dieses File für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

addViewer(emailAddress)

Der angegebene Nutzer wird der Liste der Zuschauer für die File hinzugefügt. Wenn der Nutzer bereits in der Liste der Mitbearbeiter aufgeführt war, hat diese Methode keine Auswirkungen.

Parameter

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

Rückflug

File – Dieses File für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

addViewer(user)

Der angegebene Nutzer wird der Liste der Zuschauer für die File hinzugefügt. Wenn der Nutzer bereits in der Liste der Mitbearbeiter aufgeführt war, hat diese Methode keine Auswirkungen.

Parameter

NameTypBeschreibung
userUserEine Darstellung des hinzuzufügenden Nutzers.

Rückflug

File – Dieses File für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

addViewers(emailAddresses)

Fügen Sie der Liste der Zuschauer für die File das angegebene Array von Nutzern hinzu. Wenn einer der Nutzer bereits in der Liste der Mitbearbeiter aufgeführt war, hat diese Methode keine Auswirkungen auf ihn.

Parameter

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

Rückflug

File – Dieses File für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

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 wird nicht unterstützt.

Rückflug

Permission: Die dem Nutzer gewährten Berechtigungen.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

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, erfordern eine Autorisierung für einen oder mehrere 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, der in den angegebenen Inhaltstyp konvertiert wurde. Bei dieser Methode wird dem Dateinamen die entsprechende Erweiterung hinzugefügt, z. B. „meinedatei.pdf“. Es wird jedoch davon ausgegangen, dass der Teil des Dateinamens, der auf den letzten Punkt (falls vorhanden) folgt, eine vorhandene Erweiterung ist, die ersetzt werden soll. Daraus wird „Einkaufsliste.25.12.2014“ zu „Einkaufsliste.25.12.pdf“.

Die täglichen Kontingente für Conversions finden Sie unter Kontingente für Google-Dienste. Für neu erstellte Google Workspace-Domains gelten möglicherweise vorübergehend strengere Kontingente.

Parameter

NameTypBeschreibung
contentTypeStringDer MIME-Typ, in den konvertiert werden soll. Für die meisten Blobs ist 'application/pdf' die einzige gültige Option. Bei Bildern im BMP-, GIF-, JPEG- oder PNG-Format sind auch 'image/bmp', 'image/gif', 'image/jpeg' oder 'image/png' zulässig. Für ein Google Docs-Dokument ist auch 'text/markdown' zulässig.

Rückflug

Blob – die Daten als Blob.


getBlob()

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

Rückflug

Blob – die Daten als Blob.


getDateCreated()

Das Datum, an dem die File erstellt wurde.

Rückflug

Date – das Datum, an dem die File erstellt wurde

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

getDescription()

Ruft die Beschreibung für die File ab.

Rückflug

String: Beschreibung der File

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

getDownloadUrl()

Ruft die URL ab, über die die Datei heruntergeladen werden kann. Nur Nutzer, die berechtigt sind, die Datei in Google Drive zu öffnen, können auf die URL zugreifen. Sie können diese URL in einem Browser verwenden, um die Datei herunterzuladen, aber nicht, um sie mit UrlFetchApp abzurufen. Wenn der Inhalt der Datei im Script verwendet werden soll, 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • 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 die File hat, gibt diese Methode ein leeres Array zurück.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

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

  // Gets a list of the file editors.
  const editors = file.getEditors();

  // For each file, logs the editors' email addresses to the console.
  for (const editor of editors) {
    console.log(editor.getEmail());
  }
}

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

getId()

Ruft die ID der File ab.

Rückflug

String: die ID des File

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

getLastUpdated()

Das Datum, an dem die File zuletzt aktualisiert wurde.

Rückflug

Date – das Datum, an dem die File zuletzt aktualisiert wurde

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

getName()

Ruft den Namen der File ab.

Rückflug

String – der Name der File

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

getOwner()

Ruft den Eigentümer der Datei ab.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files and logs the names of the file owners to the console.
while (files.hasNext()) {
  const file = files.next();
  console.log(file.getOwner().getName());
}

Rückflug

User: Der Dateieigentümer.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

getParents()

Eine Sammlung von Ordnern wird abgerufen, die unmittelbar übergeordnete Elemente von File sind.

Rückflug

FolderIterator: Eine Sammlung von Ordnern, die unmittelbar übergeordnete Ordner des File sind

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

getResourceKey()

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

Rückflug

String: Der Ressourcenschlüssel der File.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

getSecurityUpdateEligible()

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

Für den Zugriff auf einige Dateien oder Ordner, die über einen Link freigegeben wurden, ist in Google Drive ein Ressourcenschlüssel erforderlich. Diese Änderung ist Teil eines Sicherheitsupdates. Die Funktion ist für berechtigte Dateien und Ordner standardmäßig aktiviert. Mit setSecurityUpdateEnabled können Sie die Anforderung für Ressourcenschlüssel für berechtigte Dateien aktivieren oder deaktivieren.

Weitere Informationen zum Sicherheitsupdate für Google Drive

Rückflug

Boolean: Gibt an, ob die Anforderung für den Ressourcenschlüssel auf die File angewendet werden kann.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

getSecurityUpdateEnabled()

Gibt an, ob für diese File ein Ressourcenschlüssel für den Zugriff erforderlich ist, wenn sie über einen Link freigegeben wird. Diese Anforderung ist für berechtigte Dateien und Ordner standardmäßig aktiviert. Mit setSecurityUpdateEnabled können Sie die Anforderung für Ressourcenschlüssel für berechtigte Dateien aktivieren oder deaktivieren.

Weitere Informationen zum Sicherheitsupdate für Google Drive

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

getSharingAccess()

Gibt an, welche Nutzergruppe neben einzelnen Nutzern, denen explizit Zugriff gewährt wurde, auf das File zugreifen kann.

Rückflug

Access – die Nutzergruppe, die auf die File zugreifen kann

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

getSharingPermission()

Ruft die Berechtigung ab, die Nutzern gewährt wurde, die auf die File zugreifen können, sowie die Berechtigung einzelner Nutzer, denen explizit Zugriff gewährt wurde.

Rückflug

Permission: Berechtigungen, die Nutzern gewährt werden, die auf die File zugreifen können

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

getSize()

Die Anzahl der Byte, die zum Speichern der File in Drive verwendet werden. Google Workspace-Anwendungsdateien werden nicht auf die Speicherlimits von Google Drive angerechnet und es werden daher 0 Byte zurückgegeben.

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

getTargetId()

Wenn es sich um einen Verknüpfung handelt, wird die ID des Elements zurückgegeben, auf das sie verweist.

Andernfalls wird null zurückgegeben.

// The ID of the file for which to make a shortcut and the ID of
// the folder to which you want to add the shortcut.
// TODO(developer): Replace the file and folder IDs with your IDs.
const fileId = 'abc123456';
const folderId = 'xyz987654';

// Gets the folder to add the shortcut to.
const folder = DriveApp.getFolderById(folderId);

// Creates a shortcut of the file and moves it to the specified folder.
const shortcut = DriveApp.createShortcut(fileId).moveTo(folder);

// Logs the target ID of the shortcut.
console.log(`${shortcut.getName()}=${shortcut.getTargetId()}`);

Rückflug

String: Die ID des Zielartikels.


getTargetMimeType()

Wenn es sich um einen Verknüpfung handelt, wird der MIME-Typ des Elements zurückgegeben, auf das sie verweist.

Andernfalls wird null zurückgegeben.

// The ID of the file for which to make a shortcut and the ID of
// the folder to which you want to add the shortcut.
// TODO(developer): Replace the file and folder IDs with your IDs.
const fileId = 'abc123456';
const folderId = 'xyz987654';

// Gets the folder to add the shortcut to.
const folder = DriveApp.getFolderById(folderId);

// Creates a shortcut of the file and moves it to the specified folder.
const shortcut = DriveApp.createShortcut(fileId).moveTo(folder);

// Logs the MIME type of the file that the shortcut points to.
console.log(`MIME type of the shortcut: ${shortcut.getTargetMimeType()}`);

Rückflug

String: Der MIME-Typ des Zielelements.


getTargetResourceKey()

Wenn es sich bei der Datei um einen Verknüpfung handelt, wird der Ressourcenschlüssel des Elements zurückgegeben, auf das sie verweist. Ein Ressourcenschlüssel ist ein zusätzlicher Parameter, den Sie übergeben müssen, um auf Dateien zuzugreifen, die über einen Link freigegeben wurden.

Wenn die Datei kein Verknüpfung ist, wird null zurückgegeben.

//  Gets a file by its ID.
//  TODO(developer): Replace 'abc123456' with your file ID.
const file = DriveApp.getFileById('abc123456');

// If the file is a shortcut, returns the resource key of the file that it
// points to.
console.log(file.getTargetResourceKey());

Rückflug

String: Der Ressourcenschlüssel des Zielelements oder null, wenn es sich bei der Datei nicht um eine Verknüpfung handelt.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

getThumbnail()

Hier wird ein Thumbnail-Bild für die Datei abgerufen oder null, wenn kein Thumbnail vorhanden ist.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Logs the thumbnail image for each file to the console as a blob,
  // or null if no thumbnail exists.
  console.log(file.getThumbnail());
}

Rückflug

Blob: Das Thumbnail der Datei.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

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, über die diese File in einer Google-App wie Drive oder Docs angezeigt werden kann

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

getViewers()

Ruft die Liste der Betrachter und Kommentatoren für diese File ab. Wenn der Nutzer, der das Script ausführt, keinen Bearbeitungszugriff auf File hat, gibt diese Methode ein leeres Array zurück.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // For each file, logs the viewers' email addresses to the console.
  const viewers = file.getViewers();
  for (const viewer of viewers) {
    console.log(viewer.getEmail());
  }
}

Rückflug

User[]: Wenn der Nutzer Bearbeitungszugriff für diese File hat, wird die Liste der Betrachter und Kommentatoren zurückgegeben. Wenn der Nutzer keinen Bearbeitungszugriff hat, wird ein leeres Array zurückgegeben.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

isShareableByEditors()

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

Rückflug

Boolean – true, wenn Nutzer mit Bearbeitungsberechtigungen die Möglichkeit haben, Inhalte für andere Nutzer freizugeben oder die Berechtigungen zu ändern; false, wenn nicht

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

isStarred()

Gibt an, ob die File im Drive des Nutzers mit einem Stern markiert wurde.

Rückflug

Boolean – true, wenn die File in Google Drive mit einem Stern markiert ist; false andernfalls

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

isTrashed()

Bestimmt, ob sich die File im Papierkorb des Nutzers in Google Drive befindet.

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

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 – die neue Kopie.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

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 – die neue Kopie.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

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 – die neue Kopie.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

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 – die neue Kopie.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

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 – Dieses File für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

removeCommenter(emailAddress)

Der angegebene Nutzer wird aus der Liste der Kommentatoren für die File entfernt. Bei dieser Methode wird der Zugriff auf die File nicht für Nutzer blockiert, die zu einer Gruppe von Nutzern mit allgemeinem Zugriff gehören, z. B. wenn die File für die gesamte Domain des Nutzers freigegeben ist.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Removes the given user from the list of commenters for each file.
  // TODO(developer): Replace the email with the email of the user you want to
  // remove.
  file.removeCommenter('[email protected]');
}

Parameter

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

Rückflug

File – Dieses File für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

removeCommenter(user)

Der angegebene Nutzer wird aus der Liste der Kommentatoren für die File entfernt. Bei dieser Methode wird der Zugriff auf die File nicht für Nutzer blockiert, die zu einer Gruppe von Nutzern mit allgemeinem Zugriff gehören, z. B. wenn die File für die gesamte Domain des Nutzers freigegeben ist.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Removes the given user from the list of commenters for each file.
  console.log(file.removeCommenter(Session.getActiveUser()));
}

Parameter

NameTypBeschreibung
userUserEine Darstellung des zu entfernenden Nutzers.

Rückflug

File – Dieses File für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

removeEditor(emailAddress)

Der angegebene Nutzer wird aus der Liste der Mitbearbeiter der File entfernt. Mit dieser Methode wird der Zugriff von Nutzern auf die File nicht blockiert, wenn sie zu einer Gruppe von Nutzern mit allgemeinem Zugriff gehören. Das ist beispielsweise der Fall, wenn die File für die gesamte Domain des Nutzers freigegeben wurde oder sich die File in einer geteilten Ablage befindet, auf die der Nutzer zugreifen kann.

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

Parameter

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

Rückflug

File – Dieses File für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

removeEditor(user)

Der angegebene Nutzer wird aus der Liste der Mitbearbeiter der File entfernt. Mit dieser Methode wird der Zugriff von Nutzern auf die File nicht blockiert, wenn sie zu einer Gruppe von Nutzern mit allgemeinem Zugriff gehören. Das ist beispielsweise der Fall, wenn die File für die gesamte Domain des Nutzers freigegeben wurde oder sich die File in einer geteilten Ablage befindet, auf die der Nutzer zugreifen kann.

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

Parameter

NameTypBeschreibung
userUserEine Darstellung des zu entfernenden Nutzers.

Rückflug

File – Dieses File für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

removeViewer(emailAddress)

Der angegebene Nutzer wird aus der Liste der Zuschauer und Kommentatoren für die File entfernt. Diese Methode hat keine Auswirkungen, wenn der Nutzer ein Mitbearbeiter und kein Betrachter oder Kommentator ist. Außerdem wird mit dieser Methode der Zugriff von Nutzern auf die File nicht blockiert, wenn sie zu einer Gruppe von Nutzern mit allgemeinem Zugriff gehören. Das ist beispielsweise der Fall, wenn die File für die gesamte Domain des Nutzers freigegeben wurde oder sich die File in einer geteilten Ablage befindet, auf die der Nutzer zugreifen kann.File

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

Parameter

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

Rückflug

File – Dieses File für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

removeViewer(user)

Der angegebene Nutzer wird aus der Liste der Zuschauer und Kommentatoren für die File entfernt. Diese Methode hat keine Auswirkungen, wenn der Nutzer ein Mitbearbeiter und kein Betrachter ist. Außerdem wird mit dieser Methode der Zugriff von Nutzern auf die File nicht blockiert, wenn sie zu einer Gruppe von Nutzern mit allgemeinem Zugriff gehören. Das ist beispielsweise der Fall, wenn die File für die gesamte Domain des Nutzers freigegeben ist oder sich die File in einer geteilten Ablage befindet, auf die der Nutzer zugreifen kann.

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

Parameter

NameTypBeschreibung
userUserEine Darstellung des zu entfernenden Nutzers.

Rückflug

File – Dieses File für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

revokePermissions(emailAddress)

Hiermit wird der dem Nutzer gewährte Zugriff auf File widerrufen. Bei dieser Methode wird der Zugriff auf die File nicht blockiert, wenn Nutzer zu einer Gruppe von Nutzern mit allgemeinem Zugriff gehören, z. B. wenn die File für die gesamte Domain des Nutzers freigegeben wurde.

Parameter

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

Rückflug

File – Dieses File für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

revokePermissions(user)

Hiermit wird der dem Nutzer gewährte Zugriff auf File widerrufen. Bei dieser Methode wird der Zugriff auf die File nicht blockiert, wenn Nutzer zu einer Gruppe von Nutzern mit allgemeinem Zugriff gehören, z. B. wenn die File für die gesamte Domain des Nutzers freigegeben wurde.

Parameter

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

Rückflug

File – Dieses File für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

setContent(content)

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

// Creates a text file with the content 'Hello, world!'
const file = DriveApp.createFile('New Text File', 'Hello, world!');

// Logs the content of the text file to the console.
console.log(file.getBlob().getDataAsString());

// Updates the content of the text file to 'Updated text!'
file.setContent('Updated text!');

// Logs content of the text file to the console.
console.log(file.getBlob().getDataAsString());

Parameter

NameTypBeschreibung
contentStringDer neue Inhalt der Datei.

Rückflug

File – Dieses File für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

setDescription(description)

Legt die Beschreibung für die File fest.

Parameter

NameTypBeschreibung
descriptionStringdie neue Beschreibung für die File

Rückflug

File – dieses File für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

setName(name)

Legt den Namen der File fest.

Parameter

NameTypBeschreibung
nameStringden neuen Namen der File

Rückflug

File – dieses File für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

setOwner(emailAddress)

Ändert den Inhaber der File. Mit dieser Methode erhält der bisherige Inhaber auch ausdrücklichen Bearbeitungszugriff auf die File.

Parameter

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

Rückflug

File – dieses File für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

setOwner(user)

Ändert den Inhaber der File. Mit dieser Methode erhält der bisherige Inhaber auch ausdrücklichen Bearbeitungszugriff auf die File.

Parameter

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

Rückflug

File – dieses File für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

setSecurityUpdateEnabled(enabled)

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

Weitere Informationen zum Sicherheitsupdate für Google Drive

Parameter

NameTypBeschreibung
enabledBooleanOb die Anforderung für den Ressourcenschlüssel für die File aktiviert werden soll.

Rückflug

File – Dieses File für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

setShareableByEditors(shareable)

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

Parameter

NameTypBeschreibung
shareableBooleantrue, ob Nutzer mit Bearbeitungsberechtigungen die Möglichkeit haben sollen, die Datei für andere Nutzer freizugeben oder die Berechtigungen zu ändern; false, wenn nicht

Rückflug

File – dieses File für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

setSharing(accessType, permissionType)

Hier wird festgelegt, welche Nutzergruppe auf die File zugreifen kann und welche Berechtigungen diesen Nutzern gewährt werden, zusätzlich zu einzelnen Nutzern, die ausdrücklich Zugriff erhalten haben.

// Creates a folder that anyone on the Internet can read from and write to.
// (Domain administrators can prohibit this setting for users of a Google
// Workspace domain.)
const folder = DriveApp.createFolder('Shared Folder');
folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);

Parameter

NameTypBeschreibung
accessTypeAccessWelche Nutzergruppe sollte auf die File
permissionTypePermissiondie Berechtigungen, die Nutzern gewährt werden sollen, die auf die File zugreifen können

Rückflug

File – dieses File für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

setStarred(starred)

Gibt an, ob die File im Drive des Nutzers mit einem Stern markiert ist. Der Standardwert für neue Files ist false.

Parameter

NameTypBeschreibung
starredBooleantrue, wenn die File in Google Drive des Nutzers mit einem Stern markiert werden soll; false andernfalls

Rückflug

File – dieses File für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

setTrashed(trashed)

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

Parameter

NameTypBeschreibung
trashedBooleantrue, wenn die File in den Papierkorb des Drive-Kontos des Nutzers verschoben werden soll, false andernfalls

Rückflug

File – dieses File für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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