Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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 dans 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 dans son dossier Mon Drive, tandis qu'un groupe ou une organisation est propriétaire des fichiers dans 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 découle de ce dossier racine. L'utilisateur est le propriétaire principal de ce dossier.
Drive partagés
Un Drive partagé est une structure organisationnelle dans Drive qui existe en parallèle de Mon Drive. Vous pouvez organiser un fichier individuel dans un Drive partagé ou dans Mon Drive, mais pas dans 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 types. 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 dans Drive. Les dossiers sont des fichiers qui ne contiennent que des métadonnées et dont le type MIME est application/vnd.google-apps.folder. Pour en savoir plus, consultez Créer et remplir des dossiers.
Remarque : Un même fichier stocké dans Mon Drive peut se trouver dans plusieurs dossiers. Un fichier stocké dans un Drive partagé ne peut avoir qu'un seul dossier parent.
Document Google Workspace
Fichier créé par une application Google Workspace, comme Google Docs, Sheets ou Slides. Le format du type MIME est application/vnd.google-apps.*app*, où app est le 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 et pointant 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 et renvoyant 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 fichier de raccourci vers le contenu stocké par votre application.
Caractéristiques des fichiers
Cette liste présente certaines caractéristiques d'un fichier Drive :
: corps binaire ou textuel du fichier. Voici quelques exemples de contenus que vous pouvez stocker dans Drive : images, vidéos, texte et PDF.
ID du fichier
Identifiant unique et opaque pour chaque fichier. Les ID de fichier sont stables tout au long de la durée de vie du fichier, même si le nom du fichier 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, ainsi que les heures de création et de modification. Certains champs de métadonnées, tels que name, sont indépendants de l'utilisateur et s'affichent de la même manière pour chacun d'eux. 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 des métadonnées EXIF et d'autres métadonnées intégrées. Pour en savoir plus, consultez Gérer les métadonnées des fichiers.
Autorisation
Autorisation d'accès accordée à un utilisateur, un groupe, un domaine ou à tous 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 des autorisations pour le fichier. Pour en savoir plus, consultez Partager des fichiers, des dossiers et des Drive.
Historique des révisions
Historique des modifications apportées au contenu du fichier uniquement, et non à ses métadonnées. Pour en savoir plus sur les révisions, consultez 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 miniature. Pour en savoir plus, consultez Importer des miniatures.
Organisation des fichiers
L'API Drive organise les fichiers dans des emplacements de stockage appelés spaces et dans des collections appelées corpora.
Espaces
Emplacements de stockage spécifiques isolés les uns des autres. Tous les contenus de Drive sont stockés 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 PDF, les documents, les fichiers 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 aux utilisateurs.
Les fichiers ne peuvent pas être déplacés entre les spaces.
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 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 "Partagés avec moi".
drive : inclut tous les fichiers contenus dans un même Drive partagé, comme indiqué par driveId.
domain : inclut tous les fichiers pouvant être recherchés et partagés avec le domaine de l'utilisateur.
allDrives : inclut tous les fichiers des Drives partagés dont l'utilisateur est membre, ainsi que tous les fichiers de "Mon Drive" et "Partagés avec moi".
Utilisez les corpus allDrives avec précaution, car leur portée est large et ils peuvent affecter les performances. Dans la mesure du possible, utilisez user ou drive au lieu de allDrives pour plus d'efficacité.
Les fichiers peuvent être déplacés librement entre les corpora, car les autorisations et les droits de propriété changent.
Articles associés
Voici quelques étapes que vous pouvez également suivre :
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/04 (UTC).
[null,null,["Dernière mise à jour le 2025/08/04 (UTC)."],[],[],null,["# Files and folders overview\n\nGoogle Drive organizes files in collections, describes files by types, and\nprovides specific attributes for each file to facilitate file manipulation.\n\nThe Google Drive API represents files stored on Drive as a\n[`files`](/workspace/drive/api/reference/rest/v3/files) resource.\n| **Note:** Folders are treated as a type of file. For more details about folders, see [File types](#types).\n\nOwnership\n---------\n\nDrive organizes files based on the user's relationship with the\ncontent and its storage location. *Collections* are specified as part of the\nfile's metadata to show which group of files the file is stored with inside\nDrive. The main difference between My Drive and\nshared drive collections is file ownership. A single user is the owner of files\nin their My Drive, whereas a group or organization owns files in\na shared drive.\n\n*My Drive*\n: Each user has a \"root\" folder called \"My\n Drive\" that functions as their primary hierarchy, and\n consists of everything that descends from this root folder. The user is the\n primary owner of this folder.\n\n*Shared drives*\n: A [shared drive](/workspace/drive/api/guides/about-shareddrives) is an\n organizational structure within Drive that lives parallel to\n My Drive. You can organize an individual file within a shared\n drive or My Drive, but not both. However, [Drive shortcuts](/workspace/drive/api/guides/shortcuts) can be used to\n point to files or folders from shared drives to My Drive, or\n the other way around.\n\nFile types\n----------\n\nDrive describes files by types. This list shows all available\nfile types:\n\n*Blob*\n: A file that contains text or binary content such as images, videos, and\n PDFs.\n\n*Folder*\n\n: A container you can use to organize other types of files on\n Drive. Folders are files that only contain metadata, and have\n the MIME type `application/vnd.google-apps.folder`. For more information,\n see [Create and populate folders](/workspace/drive/api/guides/folder).\n\n **Note:** A single file stored on My Drive can be in multiple\n folders. A single file stored on a [shared\n drive](/workspace/drive/api/guides/about-shareddrives) can only have one parent folder.\n\n*Google Workspace document*\n\n: A file that a Google Workspace application\n creates, such as Google Docs, Sheets, or\n Slides. The MIME type format is\n `application/vnd.google-apps.*app*` where *app* is the application name\n (such as `application/vnd.google-apps.spreadsheet` for a\n Sheets file). For a list of Drive and\n Google Workspace-specific MIME types, see [Google Workspace and\n Google Drive supported MIME types](/workspace/drive/api/guides/mime-types).\n\n*Shortcut*\n\n: A metadata-only file that points to another file on Drive. The\n shortcut file MIME type is `application/vnd.google-apps.shortcut`. For more\n information, see [Create a shortcut to a Drive\n file](/workspace/drive/api/guides/shortcuts).\n\n*Third-party shortcut*\n\n: A metadata-only file that links to content stored on a third-party storage\n system. The third-party shortcut file MIME type is\n `application/vnd.google-apps.drive-sdk`. For more information, see [Create a\n shortcut file to content stored by your\n app](/workspace/drive/api/guides/third-party-shortcuts).\n\n| **Note:** You cannot upload or download folders, Google Workspace documents, shortcuts, and third-party shortcuts to or from Drive. However, if they use compatible formats you can upload or export Google Workspace documents. For example, you can create a Docs document when you import a PDF. Similarly, you can export a Google Slides presentation as a Microsoft PowerPoint file.\n\nFile characteristics\n--------------------\n\nThis list shows some characteristics of a Drive file:\n\n*Access proposal*\n: A proposal from a requester to an approver to grant a recipient access to a\n Drive item. For more information, see [List and resolve\n pending access\n proposals](/workspace/drive/api/guides/manage-sharing#access-proposals).\n\n*Content*\n: The binary or text body of the file. Some content examples you can store in\n Drive are images, videos, text, and PDFs.\n\n*File ID*\n: A unique, opaque ID for each file. File IDs are stable throughout the life of\n the file, even if the file name changes. [Search\n expressions](/workspace/drive/api/guides/search-files) are used to locate files by name,\n type, content, parent container, owner, or other metadata.\n\n*Metadata*\n: Data describing the contents of the file. This data includes the name, type,\n creation, and modification times. Some metadata fields, such as the `name`,\n are user-agnostic and appear the same for each user. Other fields, such as\n `capabilities` and `viewedByMeDate` contain user-specific values. File\n types, such as images and videos, contain additional metadata extracted from\n EXIF and other embedded metadata. For more information, see [Manage file\n metadata](/workspace/drive/api/guides/file).\n\n*Permission*\n: An access grant for a user, group, domain, or the world to access a file or a\n folder hierarchy. Users control who can access a file with the access\n control list (ACL), which is a list of permissions for the file. For more\n information, see [Share files, folders and\n drives](/workspace/drive/api/guides/manage-sharing).\n\n*Revision history*\n: The record of changes to the file content only, not the file metadata. For\n more details about revisions, see [Changes and revisions overview](/workspace/drive/api/guides/change-overview).\n\n*Thumbnail*\n: A graphical representation of a file. Drive automatically\n generates thumbnails for many common file types. For shortcuts and other\n file types that Drive can't render, you can provide a\n thumbnail image. For more information, see [Upload thumbnails](/workspace/drive/api/guides/file#upload-thumbnails).\n\nFile organization\n-----------------\n\nThe Drive API organizes files into storage locations, called `spaces`,\nand collections, called `corpora`.\n\n*Spaces*\n\n: Specific storage locations that are isolated from each other. All content in\n Drive is stored in one of these two defined spaces: `drive`\n and `appDataFolder`.\n\n - `drive`: Includes all user-visible files created in\n Drive. PDFs, documents, Google Docs, shortcuts, and\n other content the user uploads is located in the `drive` space.\n\n - `appDataFolder`: Includes per-user application data. Applications\n typically store configuration files and other data not intended to be\n directly accessible by users.\n\n Files cannot move between `spaces`.\n\n*Corpora*\n\n: Collections of files used to narrow the scope of file and folder searches. The\n corpora for Drive are: `user`, `domain`, `drive`, and\n `allDrives`.\n\n - `user`: Includes all files created by and opened by the user in \"My\n Drive\", and those shared directly with the user in\n \"Shared with me.\"\n\n - `drive`: Includes all files contained in a single shared drive, as\n indicated by the `driveId`.\n\n - `domain`: Includes all searchable files shared with the user's domain.\n\n - `allDrives`: Includes all files in shared drives where the user is a\n member, and all files in \"My Drive\" and \"Shared with me.\"\n Use the `allDrives` corpora with caution as it has a broad scope and can\n affect performance. When possible, use `user` or `drive` instead of\n `allDrives` for efficiency.\n\n Files can move freely between `corpora` as permissions and ownership change.\n\nRelated topics\n--------------\n\nHere are a few next steps you might take:\n\n- Learn how to [Create and manage files](/workspace/drive/api/guides/create-file).\n- Learn how to [Create and populate folders](/workspace/drive/api/guides/folder).\n- Learn how to [Upload file data](/workspace/drive/api/guides/manage-uploads).\n- Learn how to [Download and export files](/workspace/drive/api/guides/manage-downloads).\n- Learn how to [Store application-specific data](/workspace/drive/api/guides/appdata).\n- Learn how to [Display the Google Picker](/workspace/drive/api/guides/picker) on a page."]]
