Google Drive organise les fichiers dans des collections, les décrit par type et fournit des attributs spécifiques pour chaque fichier afin de faciliter leur manipulation.
L'API Google Drive représente les fichiers stockés dans Drive en tant que ressource files
.
Propriété
Drive organise les fichiers en fonction de la relation de l'utilisateur avec le contenu et de son emplacement de stockage. Les collections sont spécifiées dans les métadonnées du fichier pour indiquer le groupe de fichiers avec lequel le fichier est stocké dans Drive. La principale différence entre Mon Drive et les collections de Drive partagés réside dans la propriété des fichiers. Un seul utilisateur est propriétaire des fichiers de son dossier Mon Drive, tandis qu'un groupe ou une organisation est propriétaire des fichiers d'un Drive partagé.
- Mon Drive
- Chaque utilisateur dispose d'un dossier racine appelé "Mon Drive" qui sert de hiérarchie principale et comprend tout ce qui descend de ce dossier racine. L'utilisateur est le propriétaire principal de ce dossier.
- Un Drive partagé est une structure organisationnelle dans Drive qui coexiste avec Mon Drive. Vous pouvez organiser un fichier spécifique dans un Drive partagé ou dans Mon Drive, mais pas les deux. Toutefois, vous pouvez utiliser des raccourcis Drive pour faire pointer des fichiers ou des dossiers de Drive partagés vers Mon Drive, ou inversement.
Types de fichiers
Drive décrit les fichiers par type. Cette liste présente tous les types de fichiers disponibles:
- Blob
- Fichier contenant du texte ou du contenu binaire, comme des images, des vidéos et des PDF.
- Dossier
Conteneur que vous pouvez utiliser pour organiser d'autres types de fichiers sur Drive. Les dossiers sont des fichiers qui ne contiennent que des métadonnées et ont le type MIME
application/vnd.google-apps.folder
. Pour en savoir plus, consultez la section Créer et renseigner des dossiers.Remarque:Un même fichier stocké dans Mon Drive peut se trouver dans plusieurs dossiers. Un seul fichier stocké dans un Drive partagé ne peut avoir qu'un seul dossier parent.
- Document Google Workspace
Fichier créé par une application Google Workspace, telle que Google Docs, Sheets ou Slides. Le format de type MIME est
application/vnd.google-apps.*app*
, où app correspond au nom de l'application (par exemple,application/vnd.google-apps.spreadsheet
pour un fichier Sheets). Pour obtenir la liste des types MIME spécifiques à Drive et à Google Workspace, consultez Types MIME compatibles avec Google Workspace et Google Drive.- Raccourci
Fichier contenant uniquement des métadonnées qui pointe vers un autre fichier sur Drive. Le type MIME du fichier de raccourci est
application/vnd.google-apps.shortcut
. Pour en savoir plus, consultez Créer un raccourci vers un fichier Drive.- Raccourci tiers
Fichier contenant uniquement des métadonnées qui fait référence à du contenu stocké sur un système de stockage tiers. Le type MIME du fichier de raccourci tiers est
application/vnd.google-apps.drive-sdk
. Pour en savoir plus, consultez Créer un fichier de raccourci vers le contenu stocké par votre application.
Caractéristiques des fichiers
Voici quelques caractéristiques d'un fichier Drive:
- Proposition d'accès
- Proposition d'un demandeur à un approbateur pour accorder à un destinataire l'accès à un élément Drive. Pour en savoir plus, consultez Lister et résoudre les propositions d'accès en attente.
- Content
- Corps binaire ou textuel du fichier. Vous pouvez stocker des images, des vidéos, du texte et des fichiers PDF dans Drive.
- ID de fichier
- Identifiant opaque unique pour chaque fichier. Les ID de fichier sont stables tout au long de la durée de vie du fichier, même si son nom change. Les expressions de recherche permettent de localiser des fichiers par nom, type, contenu, conteneur parent, propriétaire ou autres métadonnées.
- Métadonnées
- Données décrivant le contenu du fichier. Ces données incluent le nom, le type, l'heure de création et de modification. Certains champs de métadonnées, tels que
name
, sont indépendants de l'utilisateur et apparaissent de la même manière pour chaque utilisateur. D'autres champs, tels quecapabilities
etviewedByMeDate
, contiennent des valeurs spécifiques à l'utilisateur. Les types de fichiers, tels que les images et les vidéos, contiennent des métadonnées supplémentaires extraites de l'EXIF et d'autres métadonnées intégrées. Pour en savoir plus, consultez Gérer les métadonnées de fichier. - Autorisation
- Accès accordé à un utilisateur, à un groupe, à un domaine ou à tous les utilisateurs pour accéder à un fichier ou à une hiérarchie de dossiers. Les utilisateurs contrôlent qui peut accéder à un fichier à l'aide de la liste de contrôle d'accès (LCA), qui est une liste d'autorisations pour le fichier. Pour en savoir plus, consultez la section Partager des fichiers, des dossiers et des Drive.
- Historique des révisions
- Enregistrement des modifications apportées au contenu du fichier uniquement, et non à ses métadonnées. Pour en savoir plus sur les révisions, consultez la section Présentation des modifications et des révisions.
- Miniature
- Représentation graphique d'un fichier. Drive génère automatiquement des miniatures pour de nombreux types de fichiers courants. Pour les raccourcis et les autres types de fichiers que Drive ne peut pas afficher, vous pouvez fournir une image miniature. Pour en savoir plus, consultez Importer des miniatures.
Organisation des fichiers
L'API Drive organise les fichiers en emplacements de stockage, appelés spaces
, et en collections, appelées corpora
.
- Espaces
Emplacements de stockage spécifiques isolés les uns des autres. Tout le contenu de Drive est stocké dans l'un de ces deux espaces définis:
drive
etappDataFolder
.drive
: inclut tous les fichiers visibles par l'utilisateur créés dans Drive. Les fichiers PDF, les documents, Google Docs, les raccourcis et les autres contenus importés par l'utilisateur se trouvent dans l'espacedrive
.appDataFolder
: inclut les données d'application par utilisateur. Les applications stockent généralement des fichiers de configuration et d'autres données qui ne sont pas destinées à être directement accessibles par les utilisateurs.
Les fichiers ne peuvent pas être déplacés d'un
spaces
à un autre.- Corpora
Ensembles de fichiers utilisés pour affiner la portée des recherches de fichiers et de dossiers. Les corpus pour Drive sont les suivants:
user
,domain
,drive
etallDrives
.user
: inclut tous les fichiers créés et ouverts par l'utilisateur dans "Mon Drive", ainsi que ceux partagés directement avec l'utilisateur dans "Partagés avec moi".drive
: inclut tous les fichiers contenus dans un seul Drive partagé, comme indiqué pardriveId
.domain
: inclut tous les fichiers pouvant être recherchés partagés avec le domaine de l'utilisateur.allDrives
: inclut tous les fichiers des Drive partagés dont l'utilisateur est membre, ainsi que tous les fichiers de "Mon Drive" et de "Partagés avec moi". Utilisez les corpusallDrives
avec prudence, car ils ont un champ d'application étendu et peuvent affecter les performances. Dans la mesure du possible, utilisezuser
oudrive
au lieu deallDrives
pour plus d'efficacité.
Les fichiers peuvent être déplacés librement entre les
corpora
à mesure que les autorisations et la propriété changent.
Articles associés
Voici quelques étapes que vous pouvez également suivre :
- Découvrez comment créer et gérer des fichiers.
- Découvrez comment créer et renseigner des dossiers.
- Découvrez comment importer des données de fichier.
- Découvrez comment télécharger et exporter des fichiers.
- Découvrez comment stocker des données spécifiques à l'application.
- Découvrez comment afficher le sélecteur Google sur une page.