Dateien und Ordner in den Papierkorb verschieben oder löschen

Sie können Google Drive-Dateien und ‑Ordner sowohl aus „Meine Ablage“ als auch aus geteilten Ablagen entfernen. Dazu haben Sie zwei Möglichkeiten: Sie können sie in den Papierkorb verschieben oder löschen.

Sie können Dateien und Ordner in den Papierkorb verschieben und sie dann wiederherstellen (innerhalb von 30 Tagen nach dem Verschieben in den Papierkorb). Wenn Sie Dateien und Ordner löschen, werden sie endgültig aus 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 die Änderungen angezeigt werden.

In dieser Anleitung wird erklärt, wie Sie Dateien in Drive entfernen können.

Parameter „fields“ verwenden

Wenn Sie die Felder angeben möchten, die in der Antwort zurückgegeben werden sollen, können Sie den fields System parameter mit einer beliebigen Methode der files Ressource festlegen. Wenn Sie den Parameter fields weglassen, gibt der Server eine Standardgruppe von Feldern zurück, die für die Methode spezifisch sind. Die Methode list gibt beispielsweise nur die Felder kind, id, name, mimeType und resourceKey für jede Datei zurück. Informationen zum Zurückgeben anderer Felder finden Sie unter Bestimmte Felder zurückgeben.

Papierkorb

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. Vor Ablauf der 30 Tage können Sie die Dateien im Papierkorb jederzeit wiederherstellen.

Nur der Dateieigentümer kann eine Datei in den Papierkorb verschieben. Andere Nutzer können jedoch weiterhin auf die Datei im Papierkorb des Eigentümers zugreifen, bis sie endgültig gelöscht wird. Wenn Sie versuchen, eine Datei in den Papierkorb zu verschieben, deren Eigentümer Sie nicht sind, erhalten Sie den insufficientFilePermissions Fehler. Weitere Informationen finden Sie unter Berechtigungen.

Wenn Sie prüfen möchten, ob Sie der Dateieigentümer sind, rufen Sie die get Methode für die files Ressource mit dem fileId Pfadparameter auf und setzen Sie den fields Parameter auf das boolesche ownedByMe Feld. Das Feld ownedByMe wird für Dateien in geteilten Ablagen nicht ausgefüllt, da sie der geteilten Ablage gehören und nicht einzelnen Nutzern. Weitere Informationen zum fields Parameter, siehe Parameter „fields“ verwenden.

Wenn Sie nicht der Dateieigentümer sind, aber trotzdem eine Kopie der in den Papierkorb verschobenen Datei benötigen, haben Sie folgende Möglichkeiten:

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

Dateien in den Papierkorb verschieben

Wenn Sie eine Datei in den Papierkorb verschieben möchten, verwenden Sie die update Methode für die files Ressource mit dem fileId Pfadparameter und setzen Sie das boolesche trashed Feld auf true. Wenn Sie eine Datei aus einer geteilten Ablage in den Papierkorb verschieben möchten, müssen Sie auch den booleschen supportsAllDrives Abfrage parameter auf true setzen. Weitere Informationen finden Sie unter Unterstützung für geteilte Ablagen implementieren.

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antwort text eine Instanz der files Ressource.

Im folgenden Codebeispiel wird gezeigt, wie Sie mit der fileId die Datei als in den Papierkorb verschoben markieren:

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 die 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 Dateieigenschaften abrufen. Verwenden Sie dazu die get Methode für die files Ressource mit dem fileId Pfadparameter und verwenden Sie eines der folgenden Felder für in den Papierkorb verschobene Dateien im fields Parameter. Weitere Informationen zum fields Parameter finden Sie unter Parameter „fields“ verwenden.

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

  • trashed: Gibt an, ob die Datei in den Papierkorb verschoben wurde, entweder explizit oder aus einem übergeordneten Ordner, der in den Papierkorb verschoben wurde. Wenn Sie trashed mit der Methode update verwenden, wird der Status der Datei festgelegt. Mit der Methode get wird der Status der Datei abgerufen.
  • explicitlyTrashed: Gibt an, ob die Datei explizit in den Papierkorb verschoben wurde, im Gegensatz zu rekursiv aus einem übergeordneten Ordner.

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

  • trashedTime: Die Zeit , zu der das Element in den Papierkorb verschoben wurde, im Datums- und Zeitformat gemäß RFC 3339. Wenn Sie die vorherige Version 2 der Drive API verwenden, heißt dieses Feld so 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

Wenn Sie eine Datei aus dem Papierkorb wiederherstellen möchten, verwenden Sie die update Methode für die files Ressource mit dem fileId Pfadparameter und setzen Sie das boolesche trashed Feld auf false. Wenn Sie eine Datei aus einer geteilten Ablage wiederherstellen möchten, müssen Sie auch den booleschen supportsAllDrives Abfrage parameter auf true setzen. Weitere Informationen finden Sie unter Unterstützung für geteilte Ablagen implementieren.

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antwort text eine Instanz der files Ressource.

Im folgenden Codebeispiel wird gezeigt, wie Sie mit der 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 die fileId der Datei, die Sie wiederherstellen möchten.

Papierkorb leeren

Mit der Methode emptyTrash für die Ressource files 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 driveId Abfrageparameter auf die ID der geteilten Ablage setzen.

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antwort text ein leeres JSON Objekt.

Im folgenden Codebeispiel wird gezeigt, wie Sie mit der fileId alle Dateien im Papierkorb endgültig 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 gelöscht haben, verliert auch jeder, für den Sie die Datei freigegeben haben, den Zugriff darauf. Wenn Sie möchten, dass andere weiterhin auf die Datei zugreifen können, können Sie die Eigentümerschaft vor dem Löschen auf eine andere Person übertragen.

Wenn ein Nutzer eine Datei aus einer geteilten Ablage löschen möchte, muss er die Rolle role=organizer für den übergeordneten Ordner haben. Wenn Sie einen Ordner löschen, werden auch alle untergeordneten Elemente gelöscht, deren Eigentümer der Nutzer ist. Weitere Informationen finden Sie unter Berechtigungen.

Wenn Sie eine Datei, deren Eigentümer ein Nutzer ist, endgültig löschen möchten, ohne sie in den Papierkorb zu verschieben, verwenden Sie die delete Methode für die files Ressource. Wenn Sie eine Datei aus einer geteilten Ablage löschen möchten, müssen Sie auch den booleschen supportsAllDrives Abfrage parameter auf true setzen. Weitere Informationen finden Sie unter Unterstützung für geteilte Ablagen implementieren.

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antwort text ein leeres JSON Objekt.

Im folgenden Codebeispiel wird gezeigt, wie Sie mit der fileId die Datei 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 die fileId der Datei, die Sie löschen möchten.

Berechtigungen

In der folgenden Tabelle sind die Rollenberechtigungen aufgeführt, die zum Verschieben von Dateien und Ordnern in den Papierkorb oder zum Löschen von Dateien und Ordnern 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 löschen
Dateien und Ordner in einer geteilten Ablage löschen [*]
Leere geteilte Ablage löschen

Leistungsspektrum

Eine files-Ressource enthält eine Sammlung boolescher capabilities-Felder, die die Berechtigungen angeben, die der Nutzer für diese Datei hat.

Wenn Sie die Berechtigungen prüfen möchten, rufen Sie die get Methode für die files Ressource mit dem fileId Pfadparameter auf und verwenden Sie eines der folgenden capabilities Felder im fields Parameter. Weitere Informationen zum fields Parameter finden Sie unter Parameter „fields“ verwenden.

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

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

Beschränkungen für Dateien und Ordner

Für Drive-Dateien und ‑Ordner sowie für Ordner in geteilten Ablagen gelten einige Speicherbeschränkungen.

Wenn das Elementlimit erreicht ist, können Sie nur Speicherplatz freigeben, indem Sie Elemente endgültig löschen oder ein anderes Konto verwenden. Das Verschieben von Dateien in den Papierkorb reicht nicht aus, um Speicherplatz freizugeben.

Weitere Informationen zu Beschränkungen für Dateien und Ordner finden Sie unter: