Les dossiers sont des fichiers qui ne contiennent que des métadonnées et qui permettent d'organiser les fichiers dans Google Drive. Elles présentent 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 les ID des dossiers parents contenant le fichier. 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
La propriété parents
peut être utilisée lors de la création de fichiers dans un dossier racine ou tout autre dossier.
Déplacer des fichiers d'un dossier à un autre
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
. 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 dossiers
Les fichiers et dossiers Drive sont soumis à certaines limites de stockage.
Limite par élément par utilisateur
Chaque utilisateur peut avoir jusqu'à 500 millions d'éléments créés via ce compte. Une fois la limite atteinte, l'utilisateur ne peut plus créer ni importer d'éléments dans Drive. Ils peuvent 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 pris en compte 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
Les objets qui ne sont pas comptabilisés dans cette limite sont les suivants:
- É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
.
Limite par élément de dossier
Chaque dossier du dossier Mon Drive d'un utilisateur est limité à 500 000 éléments. 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. Comptabilise comme un seul élément dans un dossier, même si l'élément vers lequel il pointe ne se trouve pas dans ce dossier. Pour en savoir plus, consultez Créer un raccourci vers un fichier Drive.
- Raccourcis tiers. Comptabilise comme un seul élément dans un dossier, même si l'élément vers lequel il pointe ne se trouve pas dans 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, consultez la section 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 de plus de 99 niveaux de profondeur. Cette limitation ne s'applique qu'aux dossiers enfants. Les fichiers enfants dont le type MIME est différent de application/vnd.google-apps.folder
ne sont pas concernés par cette limitation.
Par exemple, dans le schéma suivant, un nouveau dossier peut être imbriqué dans le dossier numéro 99, mais pas dans le dossier numéro 100. Toutefois, le dossier 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 de code d'état HTTP myDriveHierarchyDepthLimitExceeded
.