Les dossiers ne contiennent que des métadonnées et peuvent être utilisés pour organiser les fichiers dans Google Drive. Elles ont les propriétés suivantes:
- Un dossier est un fichier avec le type MIME
application/vnd.google-apps.folder
et n'a pas d'extension. - L'alias
root
peut être utilisé pour faire référence au dossier racine partout où un ID de fichier est fourni.
Pour en savoir plus sur les limites applicables aux dossiers Drive, consultez la section Limites applicables aux fichiers et aux dossiers.
Ce guide explique comment effectuer certaines tâches de base liées aux dossiers.
Créer un dossier
Pour créer un dossier, utilisez la méthode files.create
avec le type MIME application/vnd.google-apps.folder
et un titre. L'exemple de code suivant montre comment créer un dossier à l'aide d'une bibliothèque cliente:
Java
Python
Node.js
PHP
.NET
Créer un fichier dans un dossier spécifique
Pour créer un fichier dans un dossier spécifique, utilisez la méthode files.create
et spécifiez l'ID du dossier dans la propriété parents
du fichier.
La propriété parents
contient l'ID du dossier parent contenant le fichier.
La propriété parents
peut être utilisée lors de la création de fichiers dans un dossier racine ou dans un autre dossier.
Un fichier ne peut avoir qu'un seul dossier parent. La spécification de plusieurs parents n'est pas prise en charge.
L'exemple de code suivant montre comment créer un fichier dans un dossier spécifique à l'aide d'une bibliothèque cliente:
Java
Python
Node.js
PHP
.NET
Déplacer des fichiers entre des dossiers
Pour déplacer des fichiers, vous devez mettre à jour l'ID de la propriété parents
.
Pour ajouter ou supprimer des parents pour un fichier existant, utilisez la méthode files.update
avec les paramètres de requête addParents
et removeParents
.
Un fichier ne peut avoir qu'un seul dossier parent. La spécification de plusieurs parents n'est pas prise en charge.
L'exemple de code suivant montre comment déplacer un fichier entre des dossiers à l'aide d'une bibliothèque cliente:
Java
Python
Node.js
PHP
.NET
Limites concernant les fichiers et les dossiers
Les fichiers et dossiers Drive sont soumis à certaines limites de stockage.
Limite utilisateur/élément
Chaque utilisateur peut avoir jusqu'à 500 millions d'éléments créés par ce compte. Une fois la limite atteinte, l'utilisateur ne peut plus créer ni importer d'éléments dans Drive. Il peut toujours consulter et modifier les éléments existants. Pour recréer des fichiers, les utilisateurs doivent supprimer définitivement les éléments ou utiliser un autre compte. Pour en savoir plus, consultez Mettre des fichiers et des dossiers dans la corbeille ou les supprimer.
Les objets comptabilisés dans cette limite sont les suivants:
- Éléments créés ou importés par l'utilisateur dans Drive
- Éléments créés par l'utilisateur, mais appartenant désormais à quelqu'un d'autre
- Éléments dans la corbeille
- Raccourcis
- Raccourcis tiers
Voici les objets qui ne sont pas comptabilisés dans cette limite:
- Éléments supprimés définitivement
- Éléments partagés avec l'utilisateur, mais appartenant à quelqu'un d'autre
- Éléments appartenant à l'utilisateur, mais créés par quelqu'un d'autre
Les tentatives d'ajout de plus de 500 millions d'éléments renvoient une réponse avec code d'état HTTP activeItemCreationLimitExceeded
.
Notez que bien qu'il n'existe aucune limite au nombre d'éléments qu'un compte de service peut posséder, la limite de 500 millions d'éléments s'applique au nombre d'éléments qu'un compte de service peut créer.
Limite d'éléments par dossier
Chaque dossier du dossier Mon Drive d'un utilisateur peut contenir 500 000 éléments au maximum. Cette limite ne s'applique pas au dossier racine de Mon Drive. Les éléments pris en compte dans cette limite sont les suivants:
- Dossiers
- Fichiers Tous les types de fichiers, quel que soit leur propriétaire.
- Raccourcis. Il est comptabilisé comme un seul élément dans un dossier, même s'il pointe vers un élément se trouvant en dehors de ce dossier. Pour en savoir plus, consultez Créer un raccourci vers un fichier Drive.
- Raccourcis tiers. Il est comptabilisé comme un seul élément dans un dossier, même s'il pointe vers un élément se trouvant en dehors de ce dossier. Pour en savoir plus, consultez la section Créer un fichier de raccourci vers le contenu stocké par votre application.
Pour en savoir plus sur les limites applicables aux dossiers, consultez Limites applicables aux dossiers dans Google Drive.
Limite de profondeur de dossier
Le dossier "Mon Drive" d'un utilisateur ne peut pas contenir plus de 100 niveaux de dossiers imbriqués. Cela signifie qu'un dossier enfant ne peut pas être stocké dans un dossier comportant plus de 99 niveaux de profondeur. Cette limitation ne s'applique qu'aux dossiers enfants. Un fichier enfant dont le type MIME est différent de application/vnd.google-apps.folder
est exempté de cette limitation.
Par exemple, dans le diagramme suivant, un nouveau dossier peut être imbriqué dans le dossier numéro 99, mais pas dans le dossier 100. Toutefois, le dossier numéro 100 peut stocker des fichiers comme n'importe quel autre dossier Drive:
Les tentatives d'ajout de plus de 100 niveaux de dossiers renvoient une réponse avec code d'état HTTP myDriveHierarchyDepthLimitExceeded
.