Dateien und Ordner in den Papierkorb verschieben oder löschen

Sie können Google Drive-Dateien und -Ordner aus „Meine Ablage“ und aus geteilten Ablagen entfernen. Sie haben zwei Möglichkeiten: „Papierkorb“ oder „Löschen“.

Sie können Dateien und Ordner in den Papierkorb verschieben und dann wiederherstellen (innerhalb von 30 Tagen nach dem Löschen). Wenn Sie Dateien und Ordner löschen, werden sie endgültig aus Google Drive entfernt. Wenn Sie mehrere Dateien oder Ordner gleichzeitig in den Papierkorb verschieben, wiederherstellen oder endgültig löschen, kann es einige Zeit dauern, bis Sie die Änderungen bemerken.

In diesem Leitfaden erfahren Sie, wie Sie Dateien in Google Drive entsorgen.

Alles Müll

Wenn Sie Drive-Dateien entfernen möchten, können Sie sie in den Papierkorb verschieben. Dateien im Papierkorb werden nach 30 Tagen automatisch gelöscht. Sie können Dateien vor Ablauf der 30 Tage aus dem Papierkorb wiederherstellen.

Nur der Dateieigentümer kann eine Datei in den Papierkorb verschieben. Andere Nutzer können die Dateien im Papierkorb des Eigentümers nicht ansehen. Wenn Sie versuchen, eine Datei in den Papierkorb zu verschieben, deren Eigentümer Sie nicht sind, wird die Fehlermeldung insufficientFilePermissions angezeigt. Weitere Informationen finden Sie unter Berechtigungen.

Um zu bestätigen, dass Sie der Dateieigentümer sind, rufen Sie die Methode files.get auf, wobei fileId und der Parameter fields auf das boolesche Feld ownedByMe festgelegt sind. Das Feld ownedByMe wird für Dateien in geteilten Ablagen nicht ausgefüllt, da sie nicht einzelnen Nutzern, sondern der geteilten Ablage gehören. Weitere Informationen zum Zurückgeben von Feldern mit dem Parameter fields finden Sie unter Bestimmte Felder für eine Datei zurückgeben.

Wenn Sie nicht der Eigentümer der Datei sind, aber eine Kopie der in den Papierkorb verschobenen Datei erhalten möchten, führen Sie einen der folgenden Schritte aus:

  • Erstellen Sie eine Kopie der Datei.
  • Bitten Sie den Eigentümer, die Datei aus dem Papierkorb wiederherzustellen.

Dateien in den Papierkorb verschieben

Verwenden Sie die Methode files.update und setzen Sie das Feld trashed auf True, um eine Datei in den Papierkorb zu verschieben. Wenn Sie eine Datei einer geteilten Ablage in den Papierkorb verschieben möchten, müssen Sie auch den Abfrageparameter supportsAllDrives auf True setzen. Weitere Informationen finden Sie im Hilfeartikel Unterstützung für geteilte Ablagen implementieren.

Bei Erfolg enthält der Antworttext eine Instanz der Ressource files.

Das folgende Codebeispiel zeigt, wie Sie die Datei mit fileId in den Papierkorb verschieben:

Python

body_value = {'trashed': True}

response = drive_service.files().update(fileId="FILE_ID", body=body_value).execute()

Node.js

const body_value = {
  'trashed': True
};

const response = await drive_service.files.update({
      fileId: 'FILE_ID',
      requestBody: body_value,
    });
    return response;

Ersetzen Sie FILE_ID durch den fileId der Datei, die Sie in den Papierkorb verschieben möchten.

Eigenschaften einer in den Papierkorb verschobenen Datei ermitteln

Wenn eine Datei in den Papierkorb verschoben wird, können Sie zusätzliche files-Attribute abrufen. Sie können die Methode files.get verwenden und dem Parameter fields die folgenden Felder hinzufügen. Weitere Informationen finden Sie unter Bestimmte Felder für eine Datei zurückgeben.

Die folgenden Felder werden für alle Dateien ausgefüllt:

  • trashed: Gibt an, ob die Datei entweder explizit in den Papierkorb oder von einem übergeordneten Ordner im Papierkorb aus in den Papierkorb verschoben wurde. Wenn Sie trashed zusammen mit der Methode files.update verwenden, wird der Status der Datei durch die Methode files.get abgerufen.
  • explicitlyTrashed: Gibt an, ob die Datei aus einem übergeordneten Ordner explizit in den Papierkorb verschoben und nicht wiederkehrend in den Papierkorb verschoben wurde.

Die folgenden Felder werden nur für Dateien ausgefüllt, die sich in einer geteilten Ablage befinden:

  • trashedTime: Der Zeitpunkt, zu dem das Element in den Papierkorb verschoben wurde, im Datums-/Uhrzeitformat RFC 3339. Wenn Sie die vorherige Version 2 der Drive API verwenden, heißt dieses Feld trashedDate.
  • trashingUser: Wenn die Datei explizit in den Papierkorb verschoben wurde, der Nutzer, der sie in den Papierkorb verschoben hat.

Dateien aus dem Papierkorb wiederherstellen

Verwenden Sie zum Wiederherstellen einer Datei aus dem Papierkorb die Methode files.update und setzen Sie das Feld trashed auf False. Wenn Sie eine Datei einer geteilten Ablage aus dem Papierkorb wiederherstellen möchten, müssen Sie auch den Abfrageparameter supportsAllDrives auf True festlegen. Weitere Informationen finden Sie im Hilfeartikel Unterstützung für geteilte Ablagen implementieren.

Bei Erfolg enthält der Antworttext eine Instanz der Ressource files.

Das folgende Codebeispiel zeigt, wie Sie mit fileId die Datei als „nicht in den Papierkorb verschoben“ markieren:

Python

body_value = {'trashed': False}

response = drive_service.files().update(fileId="FILE_ID", body=body_value).execute()

Node.js

const body_value = {
  'trashed': False
};

const response = await drive_service.files.update({
      fileId: 'FILE_ID',
      requestBody: body_value,
    });
    return response;

Ersetzen Sie FILE_ID durch den fileId der Datei, die Sie aufheben möchten.

Papierkorb leeren

Mit der Methode files.emptyTrash können Sie alle Drive-Dateien, die der Nutzer in den Papierkorb verschoben hat, endgültig löschen. Wenn Sie den Papierkorb einer geteilten Ablage leeren möchten, müssen Sie auch den Abfrageparameter driveId auf die ID der geteilten Ablage festlegen.

Wenn der Vorgang erfolgreich ist, enthält der Antworttext eine leere Instanz.

Das folgende Codebeispiel zeigt, wie Sie mit fileId alle Dateien im Papierkorb löschen:

Python

response = drive_service.files().emptyTrash().execute()

Node.js

 const response = await drive_service.files.emptyTrash({
    });
    return response;

Löschen

Sie können eine Drive-Datei endgültig löschen, ohne sie in den Papierkorb zu verschieben. Wenn Sie eine Datei löschen, verlieren alle Personen, für die Sie die Datei freigegeben haben, den Zugriff darauf. Wenn Sie möchten, dass andere Nutzer weiterhin Zugriff auf die Datei haben, können Sie vor dem Löschen die Inhaberschaft an eine andere Person übertragen.

Zum Löschen einer Datei in einer geteilten Ablage muss der Nutzer role=organizer für den übergeordneten Ordner haben. Wenn Sie einen Ordner löschen, werden auch alle Nachfolgerelemente des Nutzers gelöscht. Weitere Informationen finden Sie unter Berechtigungen.

Mit der Methode files.delete können Sie eine nutzereigene Datei endgültig löschen, ohne sie in den Papierkorb zu verschieben. Wenn Sie eine Datei in einer geteilten Ablage löschen möchten, müssen Sie auch den Abfrageparameter supportsAllDrives auf True festlegen. Weitere Informationen finden Sie unter Unterstützung für geteilte Ablagen implementieren.

Wenn der Vorgang erfolgreich ist, enthält der Antworttext eine leere Instanz.

Das folgende Codebeispiel zeigt, wie Sie die Datei mit dem fileId löschen:

Python

response = drive_service.files().delete(fileId="FILE_ID").execute()

Node.js

 const response = await drive_service.files.delete({
      fileId: 'FILE_ID'
    });
    return response;

Ersetzen Sie FILE_ID durch den fileId der Datei, die Sie löschen möchten.

Berechtigungen

Die folgende Tabelle zeigt die Rollenberechtigungen, die zum Ausführen der einzelnen Vorgänge erforderlich sind. Eine vollständige Liste der Rollen und der jeweils zulässigen Vorgänge finden Sie unter Rollen und Berechtigungen.

Zulässiger Vorgang owner organizer fileOrganizer writer commenter reader
Dateien und Ordner in den Papierkorb verschieben
Dateien und Ordner aus dem Papierkorb wiederherstellen
Papierkorb leeren
Dateien oder Ordner endgültig löschen
Dateien und Ordner in einer geteilten Ablage löschen[*]

Leistungsspektrum

Eine files-Ressource enthält eine Sammlung boolescher capabilities-Felder, die angeben, ob eine Aktion für eine Datei ausgeführt werden kann.

Zum Prüfen der Funktionen rufen Sie die Methode files.get auf, wobei fileId und der Parameter fields auf das Feld capabilities festgelegt sind. Weitere Informationen zum Zurückgeben von Feldern mit dem Parameter fields finden Sie unter Bestimmte Felder für eine Datei zurückgeben.

Die folgenden Felder werden für alle Dateien ausgefüllt:

  • capabilities.canTrash: Gibt an, ob der aktuelle Nutzer diese Datei in den Papierkorb verschieben kann.
  • capabilities.canUntrash: Gibt an, ob der aktuelle Nutzer die Datei aus dem Papierkorb wiederherstellen kann.
  • capabilities.canDelete: Gibt an, ob der aktuelle Nutzer diese Datei löschen kann.
  • capabilities.canRemoveChildren: Gibt an, ob der aktuelle Nutzer Kinder aus diesem Ordner entfernen kann. Dieser Wert ist „false“, wenn das Element kein Ordner ist.

Die folgenden Felder werden nur für Dateien ausgefüllt, die sich in einer geteilten Ablage befinden:

  • capabilities.canTrashChildren: Gibt an, ob der aktuelle Nutzer die untergeordneten Elemente dieses Ordners in den Papierkorb verschieben kann. Dieser Wert ist „false“, wenn das Element kein Ordner ist.
  • capabilities.canDeleteChildren: Gibt an, ob der aktuelle Nutzer untergeordnete Elemente dieses Ordners löschen kann. Dieser Wert ist „false“, wenn das Element kein Ordner ist.