Présentation des fichiers et des dossiers

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 que capabilities et viewedByMeDate, 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 et appDataFolder.

  • 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'espace drive.

  • 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 et allDrives.

  • 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é par driveId.

  • 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 corpus allDrives avec prudence, car leur champ d'application est large et ils peuvent affecter les performances. Si possible, utilisez user ou drive au lieu de allDrives 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 :