Diese Seite wurde von der Cloud Translation API übersetzt.

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. Sie haben dazu zwei Möglichkeiten: „Papierkorb“ oder „Löschen“.

Sie können Dateien und Ordner in den Papierkorb verschieben und dann innerhalb von 30 Tagen nach dem Löschen wiederherstellen. 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 dieser Anleitung wird erläutert, wie Sie Dateien in Drive löschen können.

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. Sie können Dateien vor Ablauf der 30 Tage aus dem Papierkorb wiederherstellen.

Nur der Eigentümer einer Datei kann sie in den Papierkorb verschieben. Andere Nutzer können Dateien im Papierkorb des Eigentümers nicht aufrufen. Wenn Sie versuchen, eine Datei in den Papierkorb zu verschieben, die nicht Ihnen gehört, erhalten Sie einen insufficientFilePermissions-Fehler. Weitere Informationen finden Sie unter Berechtigungen.

Um zu prüfen, ob Sie der Inhaber der Datei sind, rufen Sie die Methode files.get auf, wobei der Parameter fileId und der Parameter fields auf das boolesche Feld ownedByMe gesetzt sind. Das Feld ownedByMe wird für Dateien in geteilten Ablagen nicht ausgefüllt, da sie der geteilten Ablage und nicht einzelnen Nutzern 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 Dateieigentümer sind, aber dennoch eine Kopie der in den Papierkorb verschobenen Datei benötigen, 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

Wenn Sie eine Datei in den Papierkorb verschieben möchten, verwenden Sie die Methode files.update und legen Sie das Feld trashed auf True fest. Wenn Sie eine Datei aus einer geteilten Ablage in den Papierkorb verschieben möchten, müssen Sie außerdem den Abfrageparameter supportsAllDrives auf True setzen. Weitere Informationen finden Sie unter Unterstützung geteilter Ablagen implementieren.

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

Das folgende Codebeispiel zeigt, wie Sie die Datei mit fileId als Papierkorbdatei 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 das fileId der Datei, die Sie in den Papierkorb verschieben möchten.

Eigenschaften einer in den Papierkorb verschobenen Datei ermitteln

Wenn eine Datei im Papierkorb ist, können Sie zusätzliche files-Properties abrufen. Sie können die Methode files.get verwenden und die folgenden Felder in den Parameter fields aufnehmen. 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 explizit oder aus einem übergeordneten Papierkorbordner in den Papierkorb verschoben wurde. Hinweis: Wenn Sie trashed mit der Methode files.update verwenden, wird der Status der Datei festgelegt. Mit der Methode files.get wird der Status der Datei abgerufen.
explicitlyTrashed: Gibt an, ob die Datei explizit aus einem übergeordneten Ordner in den Papierkorb verschoben wurde, anstatt rekursiv.

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

trashedTime: Die Uhrzeit, zu der der Artikel in den Papierkorb verschoben wurde, im Datums- und Uhrzeitformat RFC 3339. Wenn Sie die vorherige Version der Drive API 2 verwenden, heißt dieses Feld trashedDate.
trashingUser: Wenn die Datei explizit in den Papierkorb verschoben wurde, der Nutzer, der sie dorthin verschoben hat.

Dateien aus dem Papierkorb wiederherstellen

Wenn Sie eine Datei aus dem Papierkorb wiederherstellen möchten, verwenden Sie die Methode files.update und legen Sie das Feld trashed auf False fest. Wenn Sie eine Datei aus dem Papierkorb einer geteilten Ablage wiederherstellen möchten, müssen Sie außerdem den Abfrageparameter supportsAllDrives auf True festlegen. Weitere Informationen finden Sie unter Unterstützung geteilter Ablagen implementieren.

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

Das folgende Codebeispiel zeigt, wie Sie die Datei mit fileId als nicht in den Papierkorb verschobene Datei 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 das fileId der Datei, die Sie aus dem Papierkorb wiederherstellen 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 außerdem den Abfrageparameter driveId auf die ID der geteilten Ablage festlegen.

Bei Erfolg 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, verliert auch jeder, mit dem Sie die Datei geteilt haben, den Zugriff darauf. Wenn Sie möchten, dass andere weiterhin Zugriff auf die Datei haben, können Sie die Eigentümerschaft vor dem Löschen auf eine andere Person übertragen.

Um eine Datei in einer geteilten Ablage zu löschen, muss der Nutzer role=organizer für den übergeordneten Ordner haben. Wenn Sie einen Ordner löschen, werden auch alle untergeordneten Elemente gelöscht, die dem Nutzer gehören. Weitere Informationen finden Sie unter Berechtigungen.

Wenn Sie eine Datei, die einem Nutzer gehört, endgültig löschen möchten, ohne sie in den Papierkorb zu verschieben, verwenden Sie die Methode files.delete. Wenn Sie eine Datei auf einem freigegebenen Laufwerk löschen möchten, müssen Sie außerdem den Abfrageparameter supportsAllDrives auf True festlegen. Weitere Informationen finden Sie unter Unterstützung für freigegebene Ablagen implementieren.

Bei Erfolg enthält der Antworttext eine leere Instanz.

Das folgende Codebeispiel zeigt, wie Sie die Datei mit 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 das fileId der Datei, die Sie löschen möchten.

Berechtigungen

In der folgenden Tabelle sind die Rollenberechtigungen aufgeführt, die für die einzelnen Vorgänge erforderlich sind. Eine vollständige Liste der Rollen und der zugehörigen zulässigen Vorgänge finden Sie unter Rollen und Berechtigungen.

Zulässiger Vorgang	`owner`	`organizer`	`fileOrganizer`
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 ^[*]		✔

[*] Erfordert die Rolle organizer auf einem direkten oder indirekten übergeordneten Element, im Gegensatz dazu, dass die Rolle auf dem Element vorhanden ist.

Leistungsspektrum

Eine files-Ressource enthält eine Reihe von booleschen capabilities-Feldern, die angeben, ob eine Aktion auf einer Datei ausgeführt werden kann.

Rufen Sie zum Prüfen der Funktionen die Methode files.get auf, wobei die Parameter fileId und fields auf das Feld capabilities gesetzt 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 die Datei in den Papierkorb verschieben kann.
capabilities.canUntrash: Gibt an, ob der aktuelle Nutzer diese 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 untergeordnete Elemente aus diesem Ordner entfernen kann. Dies ist falsch, wenn es sich nicht um einen Ordner handelt.

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 falsch, wenn das Element kein Ordner ist.
capabilities.canDeleteChildren: Gibt an, ob der aktuelle Nutzer untergeordnete Elemente dieses Ordners löschen kann. Dies ist falsch, wenn es sich nicht um einen Ordner handelt.

Limits für Dateien und Ordner

Für Drive-Dateien und ‑Ordner sowie für geteilte Ablagen gelten einige Speicherlimits.

Wenn das Elementlimit erreicht ist, können Sie in der Regel nur dann mehr Speicherplatz freigeben, wenn Sie Elemente dauerhaft löschen oder ein anderes Konto verwenden. Das Verschieben von Dateien in den Papierkorb reicht nicht aus, um Speicherplatz freizugeben.

Weitere Informationen zu Datei- und Ordnerlimits finden Sie unter den folgenden Links: