Les dossiers sont des fichiers qui ne contiennent que des métadonnées et peuvent être utilisés pour organiser les fichiers dans Google Drive. Elles présentent les propriétés suivantes :
- Un dossier est un fichier dont le type MIME est
application/vnd.google-apps.folder
et qui 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 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 mimeType
de application/vnd.google-apps.folder
et un name
.
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 tout autre dossier.
Un fichier ne peut avoir qu'un seul dossier parent. Il n'est pas possible de spécifier plusieurs parents. Si le champ parents
n'est pas spécifié, le fichier est placé directement dans le dossier Mon Drive de l'utilisateur.
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 modifier 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. Il n'est pas possible de spécifier plusieurs parents.
.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 applicables aux fichiers et aux dossiers
Les fichiers et dossiers Drive sont soumis à des limites de stockage.
Limite d'éléments utilisateur
Chaque utilisateur peut disposer d'un maximum de 500 millions d'éléments créés par son 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 les supprimer définitivement ou utiliser un autre compte. Pour en savoir plus, consultez Placer 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 qui appartiennent désormais à quelqu'un d'autre
- Éléments dans la corbeille
- Raccourcis
- Raccourcis tiers
Les objets qui ne sont pas comptabilisés dans cette limite sont les suivants :
- Éléments définitivement supprimés
- Éléments partagés avec l'utilisateur, mais appartenant à quelqu'un d'autre
- Éléments appartenant à l'utilisateur, mais créés par une autre personne
Si vous tentez d'ajouter plus de 500 millions d'éléments, vous recevrez un code d'état HTTP activeItemCreationLimitExceeded
.
Notez que les comptes de service ne peuvent pas être propriétaires de fichiers. À la place, ils doivent importer des fichiers et des dossiers dans des Drive partagés, ou utiliser OAuth 2.0 pour importer des éléments au nom d'un utilisateur humain.
Limite d'éléments dans un 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 comptabilisés 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 au sein d'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 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 des dossiers
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 dont la profondeur est supérieure à 99 niveaux. 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 limite.
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 100 peut stocker des fichiers comme n'importe quel autre dossier Drive :
Si vous essayez d'ajouter plus de 100 niveaux de dossiers, vous recevrez un code d'état HTTP myDriveHierarchyDepthLimitExceeded
.
Articles associés
- Créer et gérer des fichiers
- Gérer les métadonnées des fichiers
- Limites applicables aux fichiers et aux dossiers dans les Drive partagés