Les dossiers sont des fichiers qui ne contiennent que des métadonnées et peuvent être utilisés pour organiser des fichiers dans Google Drive. Elles présentent les propriétés suivantes:
- Un dossier est un fichier de type MIME
application/vnd.google-apps.folder
sans 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 de dossiers Drive, consultez Limites des fichiers et des 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 lorsque vous créez des fichiers dans un dossier de premier niveau 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 des fichiers et des dossiers
Les fichiers et dossiers Drive sont soumis à certaines limites de stockage.
Limite d'éléments utilisateur
Chaque utilisateur peut disposer de 500 millions d'éléments maximum 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 supprimer définitivement les éléments ou utiliser un autre compte. Pour en savoir plus, consultez la section Placer des fichiers et des dossiers dans la corbeille ou les supprimer.
Voici les objets comptabilisés dans cette limite:
- Éléments créés ou importés par l'utilisateur dans Drive
- Éléments créés par l'utilisateur, mais détenus par une autre personne
- É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 un code d'état HTTP activeItemCreationLimitExceeded
.
Bien que le nombre d'éléments qu'un compte de service peut posséder ne soit pas limité, 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 de dossier
Dans le dossier Mon Drive d'un utilisateur,chaque dossier est limité à 500 000 éléments. 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, quelle que soit la propriété des fichiers
- 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. Comptabilisée 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 fichier de raccourci vers le contenu stocké par votre application.
Pour en savoir plus sur les limites applicables aux dossiers, consultez Limites des 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
n'est pas concerné 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 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 un code d'état HTTP myDriveHierarchyDepthLimitExceeded
.