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
ohne Erweiterung. - Mit dem Alias
root
kann überall auf den Stammordner verwiesen werden, wo eine Datei-ID angegeben ist.
Weitere Informationen zu Beschränkungen für Drive-Ordner finden Sie unter Beschränkungen für Dateien und Ordner.
In diesem Leitfaden wird erläutert, wie einige grundlegende ordnerbezogene Aufgaben ausgeführt werden.
Ordner erstellen
Verwenden Sie zum Erstellen eines Ordners die Methode files.create
mit dem MIME-Typ application/vnd.google-apps.folder
und einem Titel. Das folgende Codebeispiel zeigt, wie Sie einen Ordner mit einer Clientbibliothek erstellen:
Java
Python
Node.js
PHP
.NET
Dateien 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. Das Attribut parents
enthält die IDs der übergeordneten Ordner, in denen die Datei enthalten ist. Das folgende Codebeispiel zeigt, wie Sie mit einer Clientbibliothek eine Datei in einem bestimmten Ordner erstellen:
Java
Python
Node.js
PHP
.NET
Das Attribut parents
kann beim Erstellen von Dateien in einem Ordner auf oberster Ebene oder in einem anderen Ordner verwendet werden.
Dateien zwischen Ordnern verschieben
Wenn du Dateien verschieben möchtest, musst du die ID der parents
-Property aktualisieren.
Wenn Sie übergeordnete Dateien für eine vorhandene Datei hinzufügen oder entfernen möchten, verwenden Sie die Methode files.update
mit den Abfrageparametern addParents
und removeParents
. Das folgende Codebeispiel zeigt, wie Sie eine Datei mithilfe einer Clientbibliothek zwischen Ordnern verschieben:
Java
Python
Node.js
PHP
.NET
Beschränkungen für Dateien und Ordner
Für Drive-Dateien und -Ordner gelten einige Speicherlimits.
Maximal zulässige Anzahl von Nutzerartikeln
Jeder Nutzer kann bis zu 500 Millionen Elemente haben, die über dieses Konto erstellt wurden. Wenn das Limit erreicht ist, kann der Nutzer keine Elemente mehr in Drive erstellen oder hochladen. Vorhandene Elemente können weiterhin angesehen und bearbeitet werden. Um wieder Dateien erstellen zu können, müssen Nutzer 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.
Folgende Objekte werden auf dieses Limit angerechnet:
- Elemente, die vom Nutzer in Google Drive erstellt oder hochgeladen wurden
- Elemente, die vom Nutzer erstellt wurden, die jetzt aber einer anderen Person gehören
- Elemente im Papierkorb
- Tastenkombinationen
- Tastenkombinationen von Drittanbietern
Folgende Objekte werden auf dieses Limit nicht angerechnet:
- Dauerhaft gelöschte Elemente
- Elemente, die für den Nutzer freigegeben wurden, deren Eigentümer aber eine andere Person ist
- Elemente, die dem Nutzer gehören, aber von einer anderen Person erstellt wurden
Beim Versuch, mehr als 500 Millionen Elemente hinzuzufügen, wird der HTTP-Statuscode activeItemCreationLimitExceeded
zurückgegeben.
Limit für Ordnerelemente
Jeder Ordner in „Meine Ablage“ eines Nutzers ist auf 500.000 Elemente begrenzt. Diese Beschränkung gilt nicht für den Stammordner von „Meine Ablage“. Die folgenden Elemente werden auf dieses Limit angerechnet:
- Ordner
- Dateien. Alle Dateitypen, unabhängig von der Eigentümerschaft der Datei
- Tastenkombinationen Zählt als einzelnes Element in einem Ordner, auch wenn sich das Element, auf das es verweist, nicht in diesem Ordner befindet. Weitere Informationen finden Sie unter Verknüpfung für eine Drive-Datei erstellen.
- Verknüpfungen von Drittanbietern: Zählt als einzelnes Element in einem Ordner, auch wenn sich das Element, auf das es verweist, nicht in diesem Ordner befindet. Weitere Informationen finden Sie unter Verknüpfungsdatei zu von Ihrer Anwendung gespeicherten Inhalten erstellen.
Weitere Informationen zu Ordnerbeschränkungen finden Sie unter Ordnerbeschränkungen in Google Drive.
Limit für Ordnertiefe
„Meine Ablage“ eines Nutzers darf nicht mehr als 100 Ebenen verschachtelter Ordner enthalten. Das bedeutet, dass ein untergeordneter Ordner nicht unter einem Ordner mit mehr als 99 Ebenen gespeichert werden kann. 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 beispielsweise ein neuer Ordner in Ordner Nummer 99, aber nicht in Ordner Nummer 100 verschachtelt werden. In Ordner 100 können jedoch Dateien wie in jedem anderen Drive-Ordner gespeichert werden:
Wenn Sie versuchen, mehr als 100 Ordnerebenen hinzuzufügen, wird der HTTP-Statuscode myDriveHierarchyDepthLimitExceeded
zurückgegeben.