Ordner sind Dateien, die nur Metadaten enthalten und zum Organisieren von Dateien in Google Drive verwendet werden können. Sie haben folgende Eigenschaften:
- Ein Ordner ist eine Datei mit dem MIME-Typ
application/vnd.google-apps.folder
und hat keine Dateiendung. - Der Alias
root
kann verwendet werden, um an jeder Stelle, an der eine Datei-ID angegeben ist, auf den Stammordner zu verweisen.
Weitere Informationen zu den Limits für Google Drive-Ordner finden Sie unter Datei- und Ordnerlimits.
In diesem Leitfaden wird beschrieben, wie Sie einige grundlegende Aufgaben im Zusammenhang mit Ordnern ausführen.
Ordner erstellen
Verwenden Sie zum Erstellen eines Ordners die Methode files.create
mit dem application/vnd.google-apps.folder
-MIME-Typ und einem Titel. Das folgende Codebeispiel zeigt, wie Sie mit einer Clientbibliothek einen Ordner erstellen:
Java
Python
Node.js
PHP
.NET
Datei in einem bestimmten Ordner erstellen
Wenn Sie eine Datei in einem bestimmten Ordner erstellen möchten, verwenden Sie die Methode files.create
und geben Sie die Ordner-ID im Attribut parents
der Datei an.
Die parents
-Eigenschaft enthält die ID des übergeordneten Ordners, der die Datei enthält.
Die Property parents
kann beim Erstellen von Dateien in einem Ordner der obersten Ebene oder in einem anderen Ordner verwendet werden.
Eine Datei kann nur einen übergeordneten Ordner haben. Die Angabe mehrerer übergeordneter Ordner wird nicht unterstützt.
Das folgende Codebeispiel zeigt, wie Sie mit einer Clientbibliothek eine Datei in einem bestimmten Ordner erstellen:
Java
Python
Node.js
PHP
.NET
Dateien zwischen Ordnern verschieben
Wenn Sie Dateien verschieben möchten, müssen Sie die ID der parents
-Property aktualisieren.
Wenn Sie einer vorhandenen Datei übergeordnete Elemente hinzufügen oder daraus entfernen möchten, verwenden Sie die Methode files.update
mit den Abfrageparametern addParents
und removeParents
.
Eine Datei kann nur einen übergeordneten Ordner haben. Die Angabe mehrerer übergeordneter Ordner wird nicht unterstützt.
Im folgenden Codebeispiel wird gezeigt, wie eine Datei mithilfe einer Clientbibliothek zwischen Ordnern verschoben wird:
Java
Python
Node.js
PHP
.NET
Limits für Dateien und Ordner
Für Google Drive-Dateien und -Ordner gelten einige Speicherplatzbeschränkungen.
Limit für Nutzerelemente
Jeder Nutzer kann bis zu 500 Millionen Elemente haben, die mit diesem Konto erstellt wurden. Wenn das Limit erreicht ist, kann der Nutzer keine Elemente mehr in Drive erstellen oder hochladen. Sie können vorhandene Elemente aber weiterhin aufrufen und bearbeiten. Wenn Nutzer wieder Dateien erstellen möchten, müssen sie die Elemente endgültig löschen oder ein anderes Konto verwenden. Weitere Informationen finden Sie unter Dateien und Ordner in den Papierkorb verschieben oder löschen.
Die folgenden Objekte werden auf dieses Limit angerechnet:
- Elemente, die vom Nutzer in Drive erstellt oder hochgeladen wurden
- Elemente, die vom Nutzer erstellt wurden, aber jetzt einem anderen Nutzer gehören
- Elemente im Papierkorb
- Verknüpfungen
- Tastenkürzel von Drittanbietern
Die folgenden Objekte werden nicht auf dieses Limit angerechnet:
- Endgültig gelöschte Elemente
- Elemente, die mit dem Nutzer geteilt, aber im Besitz einer anderen Person sind
- Elemente, die dem Nutzer gehören, aber von einem anderen Nutzer erstellt wurden
Wenn Sie versuchen, mehr als 500 Millionen Elemente hinzuzufügen, wird der HTTP-Statuscode activeItemCreationLimitExceeded
zurückgegeben.
Die Anzahl der Elemente, die einem Dienstkonto gehören können, ist zwar nicht begrenzt, das Limit von 500 Millionen Elementen gilt jedoch für die Anzahl der Elemente, die ein Dienstkonto erstellen kann.
Ordnerelemente – Limit
Pro Ordner in „Meine Ablage“ sind 500.000 Elemente zulässig. Diese Beschränkung gilt nicht für den Stammordner von „Meine Ablage“. Die folgenden Elemente werden auf diese Beschränkung angerechnet:
- Ordner
- Dateien. Alle Dateitypen, unabhängig von der Dateieigentümerschaft.
- Verknüpfungen. Wird als einzelnes Element in einem Ordner gezählt, auch wenn sich das Element, auf das sie verweist, nicht in diesem Ordner befindet. Weitere Informationen finden Sie unter Verknüpfung zu einer Drive-Datei erstellen.
- Tastenkürzel von Drittanbietern Wird als einzelnes Element in einem Ordner gezählt, auch wenn sich das Element, auf das sie verweist, nicht in diesem Ordner befindet. Weitere Informationen finden Sie unter Verknüpfungsdatei zu Inhalten erstellen, die von Ihrer App gespeichert werden.
Weitere Informationen zu Ordnerlimits finden Sie unter Beschränkungen für Ordner in Google Drive.
Ordnertiefe
„Meine Ablage“ eines Nutzers darf nicht mehr als 100 Ebenen verschachtelter Ordner enthalten. Das bedeutet, dass ein untergeordneter Ordner nicht in einem Ordner gespeichert werden kann, der mehr als 99 Ebenen tief ist. Diese Einschränkung gilt nur für untergeordnete Ordner. Untergeordnete Dateien mit einem anderen MIME-Typ als application/vnd.google-apps.folder
sind von dieser Einschränkung ausgenommen.
Im folgenden Diagramm kann ein neuer Ordner beispielsweise in Ordner 99, aber nicht in Ordner 100 verschachtelt sein. Im Ordner 100 können jedoch wie in jedem anderen Drive-Ordner Dateien gespeichert werden:
Versuche, mehr als 100 Ordnerebenen hinzuzufügen, führen zu einer HTTP-Statuscode-Antwort myDriveHierarchyDepthLimitExceeded
.