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 la manipulation des fichiers.
L'API Google Drive représente les fichiers stockés sur Drive en tant que ressource File
.
Responsabilité
Drive organise les fichiers en fonction de la relation de l'utilisateur avec le contenu et son emplacement de stockage. Les collections sont spécifiées dans les métadonnées du fichier pour indiquer avec quel groupe de fichiers le fichier est stocké dans Drive. La principale différence entre les collections Mon Drive et les Drive partagés est 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 fonctionne comme hiérarchie principale et comprend tout ce qui descend de ce dossier racine. L'utilisateur est le propriétaire principal de ce dossier.
- Drive partagés
- Un Drive partagé est une structure organisationnelle de Drive parallèle à Mon Drive. Vous pouvez organiser un fichier individuel dans un Drive partagé ou dans Mon Drive, mais pas les deux. Toutefois, les raccourcis Drive peuvent être utilisés pour pointer vers 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 comportant du texte ou un contenu binaire tel que des images, des vidéos et des PDF.
- Dossier
Conteneur permettant d'organiser d'autres types de fichiers dans Drive. Les dossiers sont des fichiers qui ne contiennent que des métadonnées et sont de type MIME
application/vnd.google-apps.folder
.Remarque:Un fichier stocké dans Mon Drive peut être contenu dans plusieurs dossiers. Un fichier stocké sur un Drive partagé ne peut avoir qu'un seul dossier parent.
- Raccourci
Fichier ne contenant que 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 ne contenant que des métadonnées qui renvoie vers 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 raccourci vers un fichier externe.- Document Google Workspace
Fichier créé par une application Google Workspace (Google Docs, Sheets ou Slides, par exemple). Le format du 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 Google Sheets). Pour obtenir la liste des types MIME spécifiques à Drive et à Google Workspace, consultez Types MIME compatibles avec Google Workspace et Google Drive.
Remarque:Vous ne pouvez pas importer ni télécharger de dossiers, de raccourcis, de raccourcis tiers et de documents Google Workspace depuis ou vers Drive. Toutefois, s'ils utilisent des formats compatibles, vous pouvez importer ou exporter des documents Google Workspace. Par exemple, vous pouvez créer un document Google Docs lorsque vous importez un PDF. De même, vous pouvez exporter une présentation Google Slides au format Microsoft PowerPoint.
Caractéristiques du fichier
Cette liste présente certaines caractéristiques d'un fichier Drive:
- ID de fichier
- ID opaque unique pour chaque fichier. Les ID de fichier restent stables pendant toute 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 d'autres métadonnées.
- Metadata
- Données décrivant le contenu du fichier. Ces données incluent le nom, le type, les dates 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 du fichier EXIF et d'autres métadonnées intégrées. - Autorisation
- Autorisation d'accès accordée à un utilisateur, à un groupe, à un domaine ou au monde entier pour qu'il puisse 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 Partager des fichiers, des dossiers et des Drive.
- Content
- Corps binaire ou texte du fichier. Voici quelques exemples de contenus que vous pouvez stocker dans Google Drive : images, vidéos, texte et PDF.
- Historique des révisions
- Enregistrement des modifications apportées au contenu du fichier uniquement, pas aux métadonnées du fichier. 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 vignettes pour de nombreux types de fichiers courants. Pour les raccourcis et d'autres types de fichiers qui ne peuvent pas s'afficher dans Drive, vous pouvez fournir une vignette.
Organisation des fichiers
L'API Drive organise les fichiers dans des emplacements de stockage, appelés spaces
, et des collections, appelés 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, 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 entre les espaces.
- Société
Collections de fichiers permettant de réduire 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 la section "Partagés avec moi".drive
: inclut tous les fichiers contenus dans un seul Drive partagé, comme indiqué pardriveId
.domain
: inclut tous les fichiers inclus dans l'index de recherche et 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 des dossiers "Mon Drive" et "Partagés avec moi". Utilisez les corpusallDrives
avec prudence, car leur champ d'application est large et ils peuvent affecter les performances. Si possible, utilisezuser
oudrive
au lieu deallDrives
pour plus d'efficacité.
Les fichiers peuvent être déplacés librement entre les corpus, à mesure que les autorisations et la propriété changent.
Étapes suivantes
Voici quelques étapes que vous pouvez également suivre :
- Découvrez comment importer des données de fichier dans Drive.
- Découvrez comment télécharger et exporter des fichiers à partir de Drive.
- Découvrez comment stocker des données spécifiques à une application.
- Découvrez comment afficher le sélecteur Google sur une page.