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 ohne Erweiterung. - Der Alias
root
kann verwendet werden, um überall dort auf den Stammordner zu verweisen, wo eine Datei-ID angegeben wird.
Weitere Informationen zu den Beschränkungen für Drive-Ordner finden Sie unter Beschränkungen für Dateien und Ordner.
In diesem Handbuch wird erläutert, wie Sie einige grundlegende Aufgaben in Bezug auf Ordner ausführen.
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 mithilfe 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 mithilfe 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 einem anderen Ordner verwendet werden.
Dateien zwischen Ordnern verschieben
Wenn Sie Dateien verschieben möchten, müssen Sie die ID des Attributs parents
aktualisieren.
Wenn Sie übergeordnete Elemente 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 Dateien und Ordner in Google Drive gelten einige Speicherplatzlimits.
Limit für Nutzer-Artikel
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 sie aber weiterhin aufrufen und bearbeiten. Um wieder Dateien zu erstellen, 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, jetzt aber einem anderen Eigentümer gehören
- Elemente im Papierkorb
- Tastenkombinationen
- Tastenkombinationen von Drittanbietern
Folgende Objekte werden auf dieses Limit nicht angerechnet:
- Endgültig gelöschte Elemente
- Elemente, die für den Nutzer freigegeben wurden, aber einem anderen Eigentümer gehören
- 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.
Die Anzahl der Elemente, die einem Dienstkonto gehören können, ist nicht begrenzt. Das Limit von 500 Millionen Elementen gilt jedoch für die Anzahl der Elemente, die ein Dienstkonto erstellen kann.
Limit für Ordnerelemente
Jeder Ordner im Ordner „Meine Ablage“ eines Nutzers ist auf 500.000 Elemente beschränkt. Diese Beschränkung gilt nicht für den Stammordner von „Meine Ablage“. Folgende Elemente werden auf dieses Limit angerechnet:
- Ordner
- Dateien. Alle Dateitypen, unabhängig von der Dateieigentümerschaft.
- 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 Drive-Datei erstellen.
- Tastenkombinationen 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 Inhalten erstellen, die in Ihrer Anwendung gespeichert sind.
Weitere Informationen zu Ordnerlimits finden Sie unter Ordnerbeschränkungen in Google Drive.
Limit für die Ordnertiefe
„Meine Ablage“ eines Nutzers darf nicht mehr als 100 Ebenen verschachtelter Ordner enthalten. Das bedeutet, dass ein untergeordneter Ordner nicht in einem Ordner mit mehr als 99 Ebenen gespeichert werden kann. Diese Einschränkung gilt nur für untergeordnete Ordner. Eine untergeordnete Datei mit einem anderen MIME-Typ als application/vnd.google-apps.folder
ist von dieser Einschränkung ausgenommen.
Im folgenden Diagramm kann beispielsweise ein neuer Ordner im Ordner 99, aber nicht im Ordner 100 verschachtelt sein. Unter Ordner 100 können Dateien jedoch wie in jedem anderen Drive-Ordner gespeichert werden:
Beim Versuch, mehr als 100 Ordnerebenen hinzuzufügen, wird die HTTP-Statuscode-Antwort myDriveHierarchyDepthLimitExceeded
zurückgegeben.