Les dossiers sont des fichiers qui ne contiennent que des métadonnées et qui peuvent être utilisés pour 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 n'importe où dans un ID de fichier est fournie.
Pour en savoir plus sur les limites applicables aux dossiers Drive, consultez l'article Fichiers et les limites de 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 la méthode application/vnd.google-apps.folder
MIME
un type 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 le champ
parents
du fichier.
La propriété parents
contient l'ID du dossier parent contenant le fichier.
La propriété parents
peut être utilisée lorsque vous créez des fichiers dans un dossier de premier niveau.
dans n'importe quel autre dossier.
Un fichier ne peut avoir qu'un seul dossier parent. spécifier plusieurs parents n'est pas compatibles.
L'exemple de code suivant montre comment créer un fichier dans un dossier spécifique à l'aide de une bibliothèque cliente:
Java
Python
Node.js
PHP
.NET
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 addParents
et
removeParents
.
Un fichier ne peut avoir qu'un seul dossier parent. spécifier plusieurs parents n'est pas compatibles.
L'exemple de code suivant montre comment déplacer un fichier d'un dossier à un autre à 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 créer les utilisateurs doivent les supprimer définitivement ou utiliser un autre compte. Pour plus d'informations, consultez l'article Placer des fichiers dans la corbeille ou les supprimer dossiers.
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
Si vous tentez d'ajouter plus de 500 millions d'éléments, un
activeItemCreationLimitExceeded
Réponse avec code d'état HTTP.
Bien qu'il n'y ait pas de limite au nombre d'éléments qu'un compte de service peut la limite de 500 millions d'éléments s'applique au nombre d'éléments qu'un compte de service peuvent 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. É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. Comptabilisée comme un seul élément dans un dossier, même si l'élément qu'il pointe vers ne se trouve pas dans ce dossier. Pour en savoir plus, consultez la section Créer un un raccourci vers un fichier Drive.
- Raccourcis tiers. Comptabilisée comme un seul élément dans un dossier, même si le l’élément vers lequel il pointe ne se trouve pas dans ce dossier. Pour en savoir plus, consultez Créez un fichier de raccourci vers le contenu stocké par votre l'application Nest.
Pour en savoir plus sur les limites de dossiers, consultez la section 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. Cela signifie qu'un dossier enfant ne peut pas être stocké dans un dossier
comporte plus de 99 niveaux. Cette limitation ne s'applique qu'aux dossiers enfants. Un enfant
fichier dont le type MIME est différent de
application/vnd.google-apps.folder
n'est pas concerné par cette limitation.
Par exemple, dans le diagramme suivant, un nouveau dossier peut être imbriqué dans numéro 99 mais pas dans le dossier numéro 100. Toutefois, le dossier numéro 100 peut stocker comme n'importe quel autre dossier Drive:
Les tentatives d'ajout de plus de 100 niveaux de dossiers renvoient un
myDriveHierarchyDepthLimitExceeded
Réponse avec code d'état HTTP.