Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Google Drive conserve automatiquement un historique des modifications, ce qui peut aider les utilisateurs à suivre les modifications apportées aux fichiers et les révisions de contenu. Dans l'historique des révisions, les utilisateurs peuvent voir les modifications apportées et rétablir une version spécifique d'un fichier avec des modifications spécifiques.
Les termes suivants concernent les ressources de modifications et de révisions de l'API Google Drive :
Liste de contrôle d'accès (LCA)
Liste de toutes les ressources d'autorisation associées à un fichier, un dossier ou un Drive partagé.
Modifier
Modification apportée au contenu ou aux métadonnées d'un fichier ou d'un Drive partagé.
Journal des modifications apportées aux utilisateurs
Historique de toutes les modifications apportées par un utilisateur à chaque fichier modifiable de son espace "Mon Drive", comme un fichier Google Docs, Sheets ou Slides. Pour les membres d'un Drive partagé, le journal des modifications utilisateur inclut également des entrées sur l'appartenance à un Drive partagé, les niveaux d'accès des utilisateurs aux éléments de ce Drive partagé et les modifications apportées au nom du Drive partagé.
Journal des modifications des Drive partagés
Enregistrement de toutes les modifications apportées à un Drive partagé, comme l'ajout ou la suppression d'utilisateurs, et de toutes les modifications apportées aux éléments de ce Drive partagé. Toute modification apportée à un élément d'un Drive partagé apparaît à la fois dans le journal des modifications de l'utilisateur et dans le journal des modifications du Drive partagé.
Entrée du journal des modifications
Enregistrement d'une modification apportée au contenu ou aux métadonnées d'un fichier ou d'un Drive partagé. Une entrée du journal des modifications indique l'utilisateur qui a effectué la modification, l'horodatage et un ID. Il ne peut y avoir qu'une seule entrée par fichier ou Drive partagé à la fois dans le journal des modifications. Chaque fois que ce fichier ou ce Drive partagé est modifié, un nouvel ID est créé pour cette entrée et remplace l'entrée précédente.
Révision
Version du fichier représentant une modification du contenu du fichier (et non des métadonnées). Chaque révision est accessible à l'aide de la ressource revisions de l'API Drive.
Révision principale
Version la plus récente d'un fichier. Vous pouvez accéder à headRevisionId à l'aide de la ressource files dans l'API Drive. headRevisionId n'est disponible que pour les fichiers blob dans Drive.
Révision du blob
Version d'un fichier binaire non modifiable, comme une image, une vidéo ou un PDF. Si la révision du blob est la seule révision du fichier binaire, elle ne peut pas être supprimée. Un nouveau blob peut être importé en tant que nouvelle révision, qui devient la nouvelle révision principale de ce fichier.
Toute révision de fichier blob, autre que la révision principale, qui n'est pas désignée comme "Conserver indéfiniment" peut être supprimée. Les révisions supprimables sont généralement conservées pendant 30 jours, mais peuvent être supprimées plus tôt si un fichier comporte 100 révisions qui ne sont pas désignées comme "Conserver indéfiniment " et qu'une nouvelle révision est importée.
Historique de toutes les révisions d'un fichier dans l'ordre chronologique. Une modification apportée à un fichier Docs, Sheets ou Slides crée une révision. Chaque fois que le contenu est modifié, Drive crée une entrée dans l'historique des révisions pour ce fichier. Toutefois, ces révisions de fichiers de l'éditeur peuvent être fusionnées. Il est donc possible que la réponse de l'API n'affiche pas toutes les modifications apportées à un fichier.
Pour télécharger une révision du contenu d'un fichier blob ou exporter une révision du contenu d'un document Google Workspace, consultez Télécharger et exporter des fichiers.
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/21 (UTC).
[null,null,["Dernière mise à jour le 2025/08/21 (UTC)."],[],[],null,["# Changes and revisions overview\n\nGoogle Drive maintains an automatic history of modifications, which can help\nusers track file changes and content revisions. In the revision history, users\ncan see what edits have been made and can revert to a specific version of a file\nwith specific edits.\n\nThe following terms are relevant to the changes and revisions resources of the\nGoogle Drive API:\n\n*Access Control List (ACL)*\n: The list of all permission resources associated with a file, folder, or shared\n drive.\n\n*Change*\n: An alteration made to a file's content or metadata of a file or shared drive.\n\n*User change log*\n\n: A record of all changes that a user made to every editable file in their My\n Drive, such as a Google Docs, Sheets, or a\n Slides. For members of a shared drive, the user change log\n also includes entries about shared drive membership, user access levels to\n items in that shared drive, and shared drive name changes.\n\n | **Note:** Even if several users can access the same file, not all changes to that file are reflected in every users' change log. For example, when a user opens the file for the first time, or marks the file as Starred, those changes only appear in that users' change log. As another example, when a file's ACL is changed, it's only reflected in the change log of the following users: The file's owner, any service accounts on the ACL, and any users directly impacted by the ACL change.\n\n*Shared drive change log*\n\n: A record of all changes to a shared drive, such as additions or removals of\n users, and all changes to items on that shared drive. A change to an item\n within a shared drive appears in both the *user change log* and shared drive\n change log.\n\n*Change log entry*\n\n: A record of a change made to a file's content or metadata of a file or shared\n drive. A change log entry indicates the user who made the change, the\n timestamp, and an ID. There can only be one entry per file or shared drive\n in the change log at a time. Each time that file or shared drive changes, a\n new ID is created for that entry, and it replaces the previous entry.\n\n*Revision*\n\n: A version of the file representing a change to the file's contents (not\n metadata). Each revision can be accessed using the [`revisions`](/workspace/drive/api/reference/rest/v3/revisions) resource within the Drive API.\n\n*Head revision*\n\n: The most current version of a file. The `headRevisionId` can be accessed using\n the [`files`](/workspace/drive/api/reference/rest/v3/files) resource within the\n Drive API. The `headRevisionId` is only available for blob files\n in Drive.\n\n*Blob revision*\n\n: A version of an unmodifiable binary file, such as an image, video, or PDF. If\n the blob revision is the only revision of the binary file, it cannot be\n deleted. A new blob can be uploaded as a new *revision* , which becomes the\n new *head revision* of that file.\n\n Any blob file revision, other than the head revision, that's not designated\n as \"Keep Forever\" is purgeable. Purgeable revisions are typically preserved\n for 30 days, but can be purged earlier if a file has 100 revisions that\n aren't designated as \"Keep Forever\" and a new revision is uploaded.\n\n For more information on setting blob revisions as \"Keep Forever\", see\n [Specify revisions to save from auto\n delete](/workspace/drive/api/guides/manage-revisions#specify-revisions).\n\n*Revision history*\n\n: A record of all revisions of a file in chronological order. A change to a\n Docs, Sheets, or Slides file\n gets a new revision. Each time the content changes, Drive\n creates a new revision history entry for that file. However, these editor\n file revisions may be merged together, so the API response might not show\n all changes to a file.\n\nRelated topics\n--------------\n\n- To identify where the change you want to track is recorded, see [Identify\n which change log to track](/workspace/drive/api/guides/about-changelogs).\n- To set up change tracking for users and shared drives, see [Track changes\n for users and shared drives](/workspace/drive/api/guides/about-changes).\n- To download a blob file content revision or to export a Google Workspace document content revision, see [Download and export\n files](/workspace/drive/api/guides/manage-downloads).\n- To publish a revision, see [Manage file\n revisions](/workspace/drive/api/guides/manage-revisions).\n- To set up change notifications, see [Notifications for resource changes](/workspace/drive/api/guides/push)."]]
