Ordner sind Dateien, die nur Metadaten enthalten und zum Organisieren von Dateien in Google Drive verwendet werden können. Sie haben die folgenden Eigenschaften:
- Ein Ordner ist eine Datei mit dem MIME-Typ
application/vnd.google-apps.folderund hat keine Erweiterung. - Der Alias
rootkann verwendet werden, um auf den Stammordner zu verweisen, wenn eine Datei-ID angegeben wird.
Weitere Informationen zu den Beschränkungen für Google Drive-Ordner finden Sie unter Beschränkungen für Dateien und Ordner.
In dieser Anleitung wird beschrieben, wie Sie einige grundlegende Aufgaben im Zusammenhang mit Ordnern ausführen.
Ordner erstellen
Verwenden Sie die files.create()
Methode mit dem mimeType von application/vnd.google-apps.folder und einem name, um einen Ordner zu erstellen.
Das folgende Codebeispiel zeigt, wie Sie mit einer Clientbibliothek einen Ordner erstellen:
Java
Python
Node.js
PHP
.NET
Datei in einem bestimmten Ordner erstellen
Verwenden Sie die files.create()-Methode, um eine Datei in einem bestimmten Ordner zu erstellen. Geben Sie die Ordner-ID in der
parents-Eigenschaft der Datei an.
Die Eigenschaft parents enthält die ID des übergeordneten Ordners, der die Datei enthält.
Die Eigenschaft parents kann verwendet werden, wenn Sie Dateien in einem Ordner der obersten Ebene oder in einem anderen Ordner erstellen.
Eine Datei kann nur einen übergeordneten Ordner haben. Die Angabe mehrerer übergeordneter Elemente wird nicht unterstützt. Wenn das Feld parents nicht angegeben ist, wird die Datei direkt im Ordner „Meine Ablage“ des Nutzers platziert.
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 Eigenschaft parents aktualisieren.
Verwenden Sie die files.update()-Methode mit den Abfrageparametern addParents und
removeParents, um übergeordnete Elemente für eine vorhandene Datei hinzuzufügen oder zu entfernen.
Eine Datei kann nur einen übergeordneten Ordner haben. Die Angabe mehrerer übergeordneter Elemente wird nicht unterstützt.
Das folgende Codebeispiel zeigt, wie Sie mit einer Clientbibliothek eine Datei zwischen Ordnern verschieben:
Java
Python
Node.js
PHP
.NET
Beschränkungen für Dateien und Ordner
Für Google Drive-Dateien und -Ordner gelten einige Speicherbeschränkungen.
Beschränkung für Elemente pro Nutzer
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 Google Drive erstellen oder hochladen. Er kann aber weiterhin vorhandene Elemente ansehen und bearbeiten. Wenn Nutzer wieder Dateien erstellen möchten, müssen sie 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, deren Eigentümer aber jetzt eine andere Person ist
- Elemente im Papierkorb
- Verknüpfungen
- Verknüpfungen von Drittanbietern
Folgende Objekte werden nicht auf dieses Limit angerechnet:
- Endgültig gelöschte Elemente
- Elemente, die für den Nutzer freigegeben wurden, deren Eigentümer aber eine andere Person ist
- Elemente, deren Eigentümer der Nutzer ist, die aber von einer anderen Person erstellt wurden
Wenn Sie versuchen, mehr als 500 Millionen Elemente hinzuzufügen, wird der
activeItemCreationLimitExceeded
HTTP-Statuscode zurückgegeben.
Dienstkonten können keine Eigentümer von Dateien sein. Stattdessen müssen sie Dateien und Ordner in geteilte Ablagen hochladen oder OAuth 2.0 verwenden, um Elemente im Namen eines Nutzers hochzuladen.
Beschränkung für Elemente pro Ordner
Jeder Ordner in „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 vom Eigentümer der Datei.
- Verknüpfungen. Zählen als ein Element in einem Ordner, auch wenn sich das Element, auf das sie verweisen, nicht in diesem Ordner befindet. Weitere Informationen finden Sie unter Verknüpfung zu einer Google Drive-Datei erstellen.
- Verknüpfungen von Drittanbietern. Zählen als ein Element in einem Ordner, auch wenn sich das Element, auf das sie verweisen, nicht in diesem Ordner befindet. Weitere Informationen finden Sie unter Verknüpfungsdatei zu Inhalten erstellen, die von Ihrer App gespeichert wurden.
Weitere Informationen zu den Beschränkungen für Ordner finden Sie unter Beschränkungen für Ordner in Google Drive.
Beschränkung für die Ordnerstruktur
„Meine Ablage“ eines Nutzers darf nicht mehr als 100 Ebenen verschachtelter Ordner enthalten. Das bedeutet, dass ein Unterordner nicht in einem Ordner gespeichert werden kann, der mehr als 99 Ebenen tief verschachtelt ist. Diese Beschränkung gilt nur für Unterordner. Eine untergeordnete
Datei mit einem MIME-Typ anderer als
application/vnd.google-apps.folder ist von dieser Beschränkung ausgenommen.
Im folgenden Diagramm kann beispielsweise ein neuer Ordner in Ordner 99, aber nicht in Ordner 100 verschachtelt werden. In Ordner 100 können jedoch wie in jedem anderen Google Drive-Ordner Dateien gespeichert werden:
Wenn Sie versuchen, mehr als 100 Ordnerebenen hinzuzufügen, wird der
myDriveHierarchyDepthLimitExceeded
HTTP-Statuscode zurückgegeben.
Weitere Informationen
- Dateien erstellen und verwalten
- Dateimetadaten verwalten
- Beschränkungen von Dateien und Ordnern in geteilten Ablagen