Présentation des modifications et des révisions

Google Drive conserve un historique automatique des modifications, ce qui permet aux utilisateurs de 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 qui ont été apportées et revenir à une version spécifique d'un fichier avec des modifications spécifiques.

Les termes suivants sont pertinents pour 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é.
Modification
Modification apportée au contenu ou aux métadonnées d'un fichier ou d'un Drive partagé.
Journal des modifications de l'utilisateur

Enregistrement de toutes les modifications apportées par un utilisateur à chaque fichier modifiable de son Drive, tel qu'un document Google Docs, une feuille de calcul Google Sheets ou une présentation Google Slides. Pour les membres d'un Drive partagé, le journal des modifications de l'utilisateur inclut également des entrées concernant l'appartenance au 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 du Drive partagé

Enregistrement de toutes les modifications apportées à un Drive partagé, telles que l'ajout ou la suppression d'utilisateurs, ainsi que toutes les modifications apportées aux éléments de ce Drive partagé. Une 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é dans le journal des modifications à la fois. Chaque fois que ce fichier ou Drive partagé est modifié, un nouvel ID est créé pour cette entrée, qui 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 dans l'API Drive.

Révision principale

Version la plus récente d'un fichier. L'élément headRevisionId est accessible à l'aide de la ressource files dans l'API Drive. L'élément headRevisionId n'est disponible que pour les fichiers blob dans Drive.

Révision de blob

Version d'un fichier binaire non modifiable, comme une image, une vidéo ou un PDF. Si la révision de 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 purgée. Les révisions purgables sont généralement conservées pendant 30 jours, mais peuvent être purgé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.

Pour en savoir plus sur la définition des révisions de blob sur "Conserver indéfiniment", consultez Spécifier les révisions à enregistrer à partir de la suppression automatique.

Historique des révisions

Enregistrement de toutes les révisions d'un fichier par ordre chronologique. Une modification apportée à un fichier Docs, Sheets ou Slides reçoit une nouvelle révision. Chaque fois que le contenu est modifié, Drive crée une entrée d'historique des révisions pour ce fichier. Toutefois, ces révisions de fichier d'éditeur peuvent être fusionnées. Par conséquent, la réponse de l'API peut ne pas afficher toutes les modifications apportées à un fichier.